home *** CD-ROM | disk | FTP | other *** search
/ Best of Shareware / Best of PC Windows Shareware 1.0 - Wayzata Technology (7111) (1993).iso / mac / DOS / UTILITY / SPARKL31 / SPARKLE.DOC < prev    next >
Text File  |  1992-08-12  |  113KB  |  2,488 lines
  1.  
  2.               ---------------------------------------------------               
  3.                 -----------------------------------------------                 
  4.                   -------------------------------------------                   
  5.                     ---------------------------------------                     
  6.                       -----------------------------------                       
  7.                         -------------------------------                         
  8.                           ---------------------------                           
  9.                             -----------------------                             
  10.                               -------------------
  11.                                 ---------------                                 
  12.  
  13.                      SPARKLE
  14.                        and             by         Rob W. Smetana
  15.                     MENU MAGIC                    and Pro~Formance
  16.  
  17.                                 ---------------
  18.                               -------------------                               
  19.                             -----------------------                             
  20.                           ---------------------------
  21.                         -------------------------------                         
  22.                       -----------------------------------                       
  23.                     ---------------------------------------                     
  24.                   -------------------------------------------                   
  25.                 -----------------------------------------------                 
  26.               ---------------------------------------------------               
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.                            Sparkle & Menu Magic (tm)
  35.  
  36.  
  37.                            **  Version 3.1 (9/92)  **
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.       ====================================================================
  47.  
  48.            Copyright (C) 1990, Rob W. Smetana    All Rights Reserved
  49.  
  50.  
  51.           132 Alpine Terrace  San Francisco, CA  94117 (415) 863-0530
  52.  
  53.  
  54.             Sparkle, Menu Magic, Pro~Formance, P~F, and P-Screen are
  55.                 Trademarks of Rob W. Smetana and Brandon Smetana
  56.  
  57.       ====================================================================
  58.                                                                            
  59.  
  60.  
  61.       ====================================================================
  62.                                   Contents
  63.       ====================================================================
  64.  
  65.            Introduction ......................................   1
  66.  
  67.            Introducing Sparkle2 ..............................   2
  68.  
  69.            Sparkle's Main Features, What's New ...............   3
  70.  
  71.            Warranty and Disclaimer ...........................   4
  72.  
  73.            Limited License ...................................   5
  74.  
  75.            Registering Instantly .............................   6
  76.  
  77.            Distributing Sparkle ..............................   7
  78.  
  79.  
  80.            Quick Start:  Using Menu Magic ....................   8
  81.  
  82.              Using MM ........................................   9
  83.              ".Com" Screens or "Drawing" Menus;  Entering
  84.                 File Names ...................................  10
  85.              Choosing Colors .................................  13
  86.              Notes and More Options ..........................  14
  87.  
  88.  
  89.            Quick Start:  Using Sparkle .......................  16
  90.  
  91.              Sound Effects ...................................  17
  92.              Scrolling Bar Menus .............................  18
  93.              Ask (a 3rd menu option, or just to pause) .......  21
  94.              Big! Font .......................................  22
  95.              Quick Print .....................................  23
  96.              Windows .........................................  24
  97.              Pause ...........................................  25
  98.              Monitor .........................................  26
  99.  
  100.              A Note on Testing Errorlevels ...................  28
  101.  
  102.              Choosing a COLOR NUMBER .........................  29
  103.  
  104.            Appendix  I: Testing Errorlevels -- ASCII Codes ...  30
  105.            Appendix II: Other Programs by Pro~Formance .......  31
  106.  
  107.            Registering, Ordering .........................  Last 2 Pages
  108.  
  109.                                                                            
  110.  
  111.  
  112.       ====================================================================
  113.                                 Introduction                         1
  114.       ====================================================================
  115.  
  116.       NOTE:  This manual explains how to use TWO programs -- Sparkle
  117.              and Menu Magic (MM).  Both Sparkle.Exe and MM.Exe should
  118.              be included in this package.
  119.  
  120.               * We'll start with a general introduction. We'll then
  121.                 explain how to use Menu Magic.  MM is a "front end" to
  122.                 Sparkle.  It helps you quickly create "scrolling bar
  123.                 menu screens" and it then writes your batch files for
  124.                 you.  These batch files call on Sparkle to do the
  125.                 important work.
  126.  
  127.                 If you run MM 2-3 times, and then run the batch files
  128.                 MM writes for you, you'll get a feel for how easy it
  129.                 is to use MM and Sparkle to create fast, dynamic menus
  130.                 -- with mouse support.
  131.  
  132.               * Finally, we'll explain how to use Sparkle.  Use the
  133.                 information here to customize the batch files MM
  134.                 creates, or to create your own batch files.
  135.  
  136.                 We urge you to START by running the demo batch file:
  137.                 SP-Demo.Bat.  It'll demonstrate Sparkle's main features.
  138.                 Once you've "seen" these features in action, the dis-
  139.                 cussion of them here might make more sense.
  140.  
  141.       Included are:  Sparkle.Exe     Sparkle's main program
  142.                           MM.Exe     Menu Magic's main program
  143.                      Sparkle.Doc     This brief manual
  144.                            *.Bat     Demo batch files (run SP-DEMO!!)
  145.                       M-Menu.Com     Main Menu for demo  \ created using our
  146.                       H-Menu.Com     Demo Horizontal menu ) 
  147.                       V-Menu.Com       "  Vertical    "  / P-Screen program
  148.  
  149.                     REGISTER.Exe     To instantly convert Shareware versions
  150.                                      into fully registered versions.
  151.  
  152.       Run:          SP-Demo.Bat      For a demo of all current options.
  153.  
  154.       Purpose:      To add a little sparkle to your day or your batch
  155.                     files.  And Menu Magic will even create your scrol-
  156.                     ling bar menus and write your batch files for you!
  157.  
  158.                     Sparkle is a small program to provide MANY utilities
  159.                     useful in batch files, at the DOS command prompt,
  160.                     called from within other programs (via "shell"), etc.
  161.  
  162.                     Note that Sparkle gives you 3 different menu options.
  163.                     ASK can turn ANY screen into a menu.  The SCROLLING
  164.                     BAR menu option can turn any text screen into either
  165.                     a vertical or horizontal scrolling bar menu.
  166.  
  167.       For help:     For help, run Sparkle like this:   sparkle <Enter>.    
  168.  
  169.  
  170.       ===================================================================
  171.                             Introducing Sparkle2                     2
  172.       ===================================================================
  173.  
  174.       Many of Sparkle's users have asked for other options.  Rather
  175.       than add to the size of the original Sparkle, we created The
  176.       Sparkle Series, which includes Sparkle, Sparkle2 and Menu Magic.
  177.       Registered users RECEIVE ALL THREE PROGRAMS.
  178.  
  179.       Here's a brief summary of Sparkle2's options.  Note that although
  180.       you can use Sparkle and Sparkle2 separately, some options work
  181.       well together.  For example, Sparkle2 lets you toggle bright
  182.       background colors on and off -- for stunning, unusual colors not
  183.       normally seen on PCs.  This lets you create very dramatic windows,
  184.       Big! Font messages or print text using Sparkle's options.
  185.  
  186.       PAINT               Paint any area of the screen (from 1 character
  187.                           up to the entire screen), in any of 250 colors.
  188.                           Paint entire areas or just a border around areas.
  189.  
  190.       REVERSE COLORS      Reverse the colors in any area of the screen
  191.                           (foreground colors become background colors,
  192.                           and vice versa).  Reverse colors in an entire
  193.                           area, or just a border around the area.
  194.  
  195.       BRIGHT BACKGROUNDS  Enable or disable bright backgrounds.  Use alone,
  196.                           or in combination with Paint and/or Reverse.
  197.  
  198.       GET RESPONSE        Get input from the user, from 1 - 80 characters.
  199.                           Sparkle2 will pass this back to you either in
  200.                           an environment variable, or by writing it to a
  201.                           file.  You may specify:  1) a "prompt" (optional);
  202.                           2) where on the screen we should get input; 3)
  203.                           what colors to use; and, 4) the maximum AND
  204.                           minimum number of characters we'll accept.
  205.  
  206.       PROMPT              Prompt the user for a keypress with attention-
  207.                           getting:  Twirling Batons, Exploding Buttons
  208.                           or a Scrolling Banner.
  209.  
  210.       VIEW FILE           Let you view ANY ASCII text file of ANY size
  211.                           and ANY width:
  212.                            * Inside any-size window on your screen.
  213.                            * In any color you like.
  214.  
  215.                           You can create very dramatic effects by display-
  216.                           screens with colored windows, then displaying
  217.                           text files inside the windows.
  218.  
  219.       DOS VERSION         Determine which version of DOS is being used.
  220.                           This information can help you determine if a
  221.                           program will run (some require later versions
  222.                           of DOS), or if DOS features are available.
  223.  
  224.                                                                        
  225.  
  226.  
  227.       ====================================================================
  228.                             Sparkle's Main Features                  3
  229.       ====================================================================
  230.  
  231.        * SCROLLING BAR MENUS
  232.  
  233.          Turn ANY text screen into a vertical or horizontal Scrolling
  234.          Bar Menu.  Menu Magic even creates your menu screens for you.
  235.  
  236.        * ASK
  237.  
  238.          Turn ANY screen (text or graphics) into a menu, or use Ask just
  239.          to pause; print a prompt on any row or column in any color;
  240.          specify which keys are "valid."
  241.  
  242.        * Big! Font (tm)   Print 8-line-high messages, in any color!
  243.  
  244.        * WINDOWS   250+ frame styles; with or without shadows, in any color.
  245.  
  246.        * QUICK PRINT  Print text anywhere on the screen in any color.
  247.  
  248.        * SOUND EFFECTS  Over 35 sound effects, from simple to elaborate.
  249.  
  250.        * PAUSE   Pause from 1/3 second to ??; you may also let the user
  251.          press a key to bypass the pause.
  252.  
  253.        * MONITOR   Determine what type of display adapter & monitor is active.
  254.  
  255.       ====================================================================
  256.                                 WHAT'S NEW
  257.       ====================================================================
  258.  
  259.       If you've used earlier versions of Sparkle, NOTE the changes to
  260.       the Scrolling Bar menu option.  And Sparkle now supports a mouse!
  261.  
  262.        Version   Date   What's New
  263.        -------   ----   --------------------------------------------
  264.        3.1       9/92   Added an EXPLODING window option (option -6).
  265.  
  266.        3.0       11/91  Added Menu Magic to create bar menu screens
  267.                         and write your batch files for you.
  268.  
  269.        2.9/2.9c  10/91  Restored color parameter in BAR menus.
  270.                  6/91   You can now repeat sound effects (suggested by
  271.                         Mark Dodd of Texas); tamed the "shareware re-
  272.                         minder" (thanks to V. Baxter of California).
  273.  
  274.        2.8       5/91   Added mouse support to Scrolling Bar Menus.
  275.                         Eliminated "color" parameter in Bar menus --
  276.                         Sparkle now reverses whatever colors are there.
  277.  
  278.        2.7      11/90   Added "Phone" sound, "Pause" and "Monitor options.
  279.        2.4-2.6   9/90   Added 250+ frame styles to the "Window" option.
  280.                         Fixed bug: ASK didn't return 27 if Esc pressed.
  281.        2.3       6/90   1st public release.                            
  282.  
  283.  
  284.       ====================================================================
  285.                             WARRANTY & DISCLAIMER                    4
  286.       ====================================================================
  287.  
  288.       This product is provided "AS IS" without warranty of any kind.
  289.       The entire risk as to the results and performance of this pro-
  290.       duct is assumed by you.  We warrant only that any disks we sent
  291.       you are free from physical and workmanship defects under normal
  292.       use and service for a period of 90 days from the date shipped.
  293.  
  294.       Our entire liability, and your exclusive remedy, as to the disk,
  295.       shall be to, at our option, either (1) return the purchase price;
  296.       or, (2) replace disks which don't meet our limited warranty.  Since
  297.       you can try "user supported" versions of our programs before order-
  298.       ing them, we offer no other warranty beyond that stated here. We'll
  299.       gladly replace defective disks; but no refunds/credits can be issued.
  300.  
  301.       Neither Pro~Formance nor RWS & Associates nor Rob W. Smetana, nor
  302.       any of their officers or employees shall be held respon- sible
  303.       for:  failures of this product to satisfy any needs, damages due
  304.       to using this product, or any effects this program has on you,
  305.       your business or operations.
  306.  
  307.       This product, its manual and any supporting materials may be
  308.       modified or changed from time to time.  They may contain opera-
  309.       tional inaccuracies or typographical errors which may be cor-
  310.       rected by future versions, if any.  Registered users may be
  311.       notified of available updates.
  312.  
  313.  
  314.                                                                         
  315.  
  316.  
  317.       ===================================================================
  318.                                 LIMITED LICENSE                      5
  319.       ===================================================================
  320.  
  321.  
  322.       *** See the next page for details on INSTANT registration. ***
  323.  
  324.  
  325.       Sparkle is NOT public domain or free software.  It is distri-
  326.       buted as "user-supported" software or "shareware."
  327.  
  328.       If you decide to use Sparkle beyond the trial period, we ask
  329.       for a modest contribution to help us add other useful options.
  330.       You'll find a registration form at the end of this manual.
  331.  
  332.  
  333.       Non-registered users of this software are granted a limited
  334.       license to "try out" the user-supported version, on a private,
  335.       non-commercial basis, for the express purpose of determining
  336.       whether it suits your needs.  At the end of this trial period,
  337.       you must either register your copy or stop using it.
  338.  
  339.       * Running Sparkle 15-20 different times should allow you
  340.         to decide if it's going to be useful to you.  Therefore
  341.         the "trial period" is set at 20 Sparkle sessions.
  342.  
  343.       ==============================================================
  344.  
  345.         WARNING:  You MAY NOT use this program in any organization
  346.         or in the conduct of any business activity without a prior
  347.         purchase or license arrangement.
  348.  
  349.         Neither Sparkle nor Menu Magic be distributed with any other
  350.         product or service without a prior license arrangement.
  351.  
  352.       ==============================================================
  353.  
  354.       What does all this really mean?  It's really very simple.  Try
  355.       it.  Then either pay for it, or stop using it.
  356.  
  357.        * If you use this program, then you should pay for your copy.
  358.          Sparkle is NOT free, and we're not giving away free copies.
  359.          We are giving you the chance to try it before you buy it.
  360.  
  361.        * Paying for this software allows us to stay in business and
  362.          provide you with support, enhancements and updates.
  363.  
  364.  
  365.          The next page explains the 2 ways you have to register.
  366.  
  367.                                                                        
  368.  
  369.  
  370.       ===================================================================
  371.                              Registering INSTANTLY                   6
  372.       ===================================================================
  373.  
  374.       You can register for Sparkle in two ways:  By mail (see the
  375.       registration form at the end of this manual), or INSTANTLY by
  376.       phone (with a Visa or MasterCard number).  You can also elect
  377.       to have the latest version of Sparkle sent to you.
  378.  
  379.       Shareware versions of Sparkle include REGISTER.Exe.  Run Register
  380.       to convert shareware versions into fully registered versions.
  381.  
  382.       SHAREWARE VERSIONS OF Sparkle and Menu Magic ARE FULLY FUNCTIONING!
  383.  
  384.       They have ALL the features of registered versions, with NO limita-
  385.       tions.  However, shareware versions will periodically remind you
  386.       to register by displaying something like this message:
  387.  
  388.        Reminder:  This is an unregistered version.  Run Register.Exe
  389.  
  390.       Early versions of Sparkle had NO built-in reminder, and 2 people
  391.       registered!  Enjoy Sparkle, but remember it is "user-supported."
  392.  
  393.       This reminder disappears when you run REGISTER (or receive a
  394.       registered version from us).
  395.  
  396.                To Register Instantly Using REGISTER.Exe . . .
  397.                ==============================================
  398.  
  399.       Step 1:  Be sure that Sparkle.Exe, MM.Exe and REGISTER.Exe are on
  400.                the drive/directory you're logged onto (Sparkle.Exe and
  401.                MM.Exe MUST be).
  402.  
  403.       Step 2:  You'll call us twice at (415) 863 - 0530.
  404.                * The first time you call, give us your name, address
  405.                  and Visa or MasterCard number.
  406.                * We'll verify the credit card information and add your
  407.                  name to our database so we can notify you about updates.
  408.  
  409.       Step 3:  BEFORE you call us the 2nd time:
  410.                * Be sure Sparkle.Exe is on the current drive/directory.
  411.                  Now run REGISTER.Exe.  REGISTER will ask for the
  412.                  name of the program you want to register.  Type in
  413.                  "sparkle" (without the quotation marks and without .EXE).
  414.  
  415.                * REGISTER will then print a number.
  416.                  - CALL US when that number is on your screen and
  417.                    tell us what the number is.
  418.                  - We'll give you a different number to type in.
  419.  
  420.                * REGISTER will then ask you to enter your name.  Type in
  421.                  your name and you'll have a fully-registered version.
  422.  
  423.       Step 4:  Repeat step 4 for Menu Magic.  You need NOT call us again.
  424.                But you will have to tell us the number REGISTER gives you.
  425.                                                                           
  426.  
  427.  
  428.       ===================================================================
  429.                              DISTRIBUTING  Sparkle                   7
  430.       ===================================================================
  431.  
  432.       Bulletin board Sysops, clubs and shareware distributors may
  433.       copy and distribute SHAREWARE versions of Sparkle, provided:
  434.  
  435.       *** Your company name IS NOT:   California Freeware         ***
  436.                                         American Freeware
  437.                                               US Freeware
  438.           or any other firm, group or association with "Freeware"
  439.           in its name, literature, adds, etc., which companies are
  440.           PROHIBITED from distributing ANY products by Rob W. Smetana,
  441.           Pro~Formance, RWS & Associates or their officers, staff or
  442.           associates.
  443.  
  444.       *** Your adds, literature and company name DO NOT include:   ***
  445.           "free software," "freeware," "free" or other such
  446.           terms which misrepresent "user-supported" software.
  447.  
  448.       (1) It is distributed in completely unmodified form, and you
  449.           include all these files intact:
  450.  
  451.           Sparkle.Exe, Sparkle.Doc, SP-Demo.Bat, V-Menu.Com, H-Menu.Com
  452.  
  453.       (2) You charge nothing other than a "disk distribution fee"
  454.           of up to $8.00 to cover distribution and handling.
  455.  
  456.       (3) You state YOUR fee is NOT payment or registration for
  457.           OUR software.
  458.  
  459.       (4) You clearly encourage registration by stating that con-
  460.           tinued use justifies sending contributions to the developer.
  461.  
  462.       (5) You include all these files intact:
  463.  
  464.           Sparkle.Exe, Sparkle.Doc, MM.Exe, SP-Demo.Bat, M-Menu.Com,
  465.           V-Menu.Com, H-Menu.Com and other batch files.
  466.  
  467.  
  468.                                                                          
  469.  
  470.  
  471.       ===================================================================
  472.                         Quick Start:  Using Menu Magic               8
  473.       ===================================================================
  474.  
  475.       Menu Magic is a fast, easy-to-use program to write batch files
  476.       that offer SCROLLING BAR MENUS -- with mouse support, colors,
  477.       drop shadows, etc.  MM is a "front end" to Sparkle.  Use MM to
  478.       create your "menu screens" and write your batch file.  When
  479.       you run this batch file, Sparkle takes over and turns your
  480.       "menu screen" into a colorful, scrolling bar menu, complete
  481.       with mouse support.
  482.  
  483.        * Just type in your menu options (and a title if you like).
  484.  
  485.        * Choose the colors you want.
  486.  
  487.        * Then press a key and MM will write your batch file for you.
  488.  
  489.          You can test this batch file immediately.  Then, edit the
  490.          batch file and customize the last section (so when you
  491.          choose menu options, the batch file takes the appropriate
  492.          action -- executes a program, exits to DOS, changes drives
  493.          or directories, etc.).
  494.  
  495.  
  496.       And MM offers two ways to display your actual menu screen.
  497.  
  498.        * You can save menu screens to ".COM" files.  Just "run"
  499.          these files to display your menu screens instantly!  (Your
  500.          batch file does this for you.)
  501.  
  502.          - You can see examples of .Com screens by running
  503.            SP-Demo.Bat.  It will run several .Com screens we
  504.            included with Sparkle.  We created these .Com
  505.            screens using our P-Screen program.  P-Screen
  506.            offers you more screen-design options than MM
  507.            can.  See "More Options" for details.
  508.  
  509.  
  510.        * Or, if you prefer, MM will write your batch file in such a
  511.          way that your screen is "drawn" by the batch file -- with
  512.          colors and shading (using some of Sparkle's many options).
  513.  
  514.  
  515.                                                                        
  516.  
  517.  
  518.       TO USE MM                                                      9
  519.       =========
  520.  
  521.       At the DOS prompt type:    MM <Enter>
  522.  
  523.       Creating a menu takes 4 simple steps:
  524.  
  525.        * Enter your menu options (and a title if you want one).
  526.  
  527.        * Tell MM "how" to create your screen (with a .Com screen
  528.          or by drawing it in your batch file).
  529.  
  530.        * Give us a name.
  531.  
  532.        * Choose colors.
  533.  
  534.  
  535.  
  536.       When you run MM, the following screen appears.
  537.  
  538.  
  539.       =================================================================
  540.  
  541.       Menu Magic  Copyright 1991, Brandon Smetana   All Rights Reserved
  542.  
  543.               Title:   ___________________________________
  544.  
  545.              Option:   ___________________________________  Working on:
  546.  
  547.              Option:   ___________________________________    Title
  548.  
  549.              Option:   ___________________________________
  550.  
  551.              Option:   ___________________________________  Alt-C = Center
  552.                                                             It is now  OFF
  553.              Option:   ___________________________________
  554.                                                                Esc = Quit
  555.              Option:   ___________________________________
  556.                                                              <F10> = Done
  557.              Option:   ___________________________________
  558.  
  559.              Option:   ___________________________________
  560.  
  561.  
  562.         Enter a TITLE for your batch file menu (optional), plus up to
  563.         8 menu options.   Each may have 1-40 characters.  Leave any
  564.         field blank.   Press <Esc> to quit (to exit and save nothing).
  565.  
  566.       =================================================================
  567.  
  568.       NOTE: Press <Esc> (the Escape key) if you want to exit MM.
  569.       Nothing will be saved.  So press <Esc> only if you're sure
  570.       you want to cancel what you began.
  571.  
  572.                                                                        
  573.  
  574.  
  575.       Using MM (continued)                                           10
  576.  
  577.  
  578.       Entering a Title
  579.       ================
  580.  
  581.       When MM starts up, it highlights the area next to "Title"
  582.       (shown as "_____" above).
  583.  
  584.        * Enter a title if you like -- it's optional.  NOTE:  Titles
  585.          are always centered on the top line of your menu.  Feel free
  586.          to center it on MM's screen if you like.  But you don't have
  587.          to since we'll center it when we later draw your menu.
  588.  
  589.  
  590.       Entering Menu Options
  591.       =====================
  592.  
  593.       Once you enter a title (or decide to leave it blank), press
  594.       <Enter> or the Down cursor key.  MM will then highlight the
  595.       area next to the first "Option" shown above.
  596.  
  597.        * You can enter up to 8 menu options, with 1 - 40 characters
  598.          each.  If you need more than 8 options see "More Options."
  599.  
  600.  
  601.        * MM begins with "centering mode" OFF.  That means that anything
  602.          you enter will NOT be centered (it'll appear exactly as you
  603.          type it -- except for the title which is always centered).
  604.  
  605.          Press alt-C to turn "centering mode" ON and center menu options
  606.          within the space shown (hold down the Alt key, then press "C").
  607.  
  608.          - Once you press Alt-C, MM will center the item, and then move
  609.            to the next one.  Then, as you enter each item, they'll be
  610.            automatically centered.
  611.  
  612.          - If you press Alt-C again, MM turns centering mode OFF.
  613.  
  614.            This won't affect anything you've already entered.  But if
  615.            you want to adjust the spacing on any item, turn centering
  616.            OFF, then press up or down cursor keys until MM highlights
  617.            the item you want to edit.  Edit the item to your liking.
  618.  
  619.  
  620.        * You can leave any of the 8 options blank.  This lets you
  621.          separate 1 or more options from others by leaving a blank
  622.          one in between.
  623.  
  624.          For example, some people like to separate "Quit" from their
  625.          main menu options.  At other times, they separate certain
  626.          clusters of options from other clusters with more blank
  627.          space in between.
  628.  
  629.                                                                        
  630.  
  631.  
  632.       When You're Done                                              11
  633.       ================
  634.  
  635.       Press <F10> (Function key F10) when you're done entering menu
  636.       options.  (Press <Esc> to cancel what you've begun.)
  637.  
  638.       When you press <F10>, MM asks you two questions:
  639.  
  640.        1.  Do you want to save your menu as a ".COM" screen?  Or
  641.            should MM "draw" your menu in the batch file itself?
  642.  
  643.        2.  What file name should MM use to create batch file(s)?
  644.  
  645.  
  646.       The first question will actually look like this:
  647.  
  648.          Do you want to display the menu with a COM screen, or draw
  649.          it using Sparkle's options?  Press <C>om or <D>raw:
  650.  
  651.        * Note that if you press <D>, you're telling MM to write your
  652.          batch file in such a way that Sparkle will be used to dis-
  653.          play your colored, shadowed menu.
  654.  
  655.        * .Com screens display instantly.  So they're often the best
  656.          way to display menus.  But .Com screens are separate files.
  657.          If you're concerned that this file might be separated from
  658.          your batch file, you might want to <D>raw your menu.  This
  659.          is the safest (but slowest) option.
  660.  
  661.        * Since MM is so easy to use, experiment with both approaches
  662.          to see which you prefer, which suits your needs the best.
  663.  
  664.       The 2nd question actually looks like this:
  665.  
  666.          Enter a 1-8 character file name [default = MENU].
  667.          DON'T add extension(s) (eg.,'.Bat').  We'll add them for you:
  668.  
  669.  
  670.        * Just type in a 1-8 character file name, then press <Enter>.
  671.  
  672.        * If you leave this blank, MM will create "MENU.BAT."
  673.  
  674.        * Please DO NOT enter extensions.  We'll add ".Bat" (and
  675.          ".Com" if appropriate) for you.
  676.  
  677.       Warning
  678.       =======
  679.  
  680.       If you enter a file name that already exists, MM will overwrite
  681.       it -- without warning you.  So, if you're not sure if a .Bat
  682.       or .Com file already exists, enter a very unusual name (like
  683.       890_gql).  Then, when MM's done saving your files, just rename
  684.       the .Bat and .Com files to anything you like.  And when you're
  685.       editing your batch file, remember to change the name of .Com
  686.       screen you're displaying.
  687.                                                                        
  688.  
  689.  
  690.       COM Screen Names                                              12
  691.       ================
  692.  
  693.       If you told MM to save a COM screen, it saves a file with the
  694.       "file name" you entered -- but with the first letter changed
  695.       to "!".  For example:
  696.  
  697.        * If you save MENU.BAT, MM saves your COM screen as !ENU.COM.
  698.  
  699.        * If you save LOGON.BAT, MM save the COM screen as !OGON.COM.
  700.  
  701.  
  702.       The reason for these unusual names for .Com files is that we
  703.       can't save a .Bat and a .Com file with the same name.  Why?
  704.  
  705.        * Suppose we saved both Menu.Com and Menu.Bat.  Later, when
  706.          you type "menu <Enter>" to run Menu.Bat it would NOT run.
  707.          Menu.Com would run instead!
  708.  
  709.        * That's because when you run a program, DOS first looks for a
  710.          .Com file by that name.  If found, DOS runs it.  If DOS can't
  711.          find it, it looks for an .Exe file by that name.  If found,
  712.          DOS runs it.  If not found, DOS then looks for a .Bat file.
  713.  
  714.          Since batch files are the last in this "pecking order," if
  715.          you have a batch file with the SAME NAME as a .Com or .Exe
  716.          file, your batch file may never run!
  717.  
  718.  
  719.  
  720.       Feel free to rename the file(s) MM saves to anything you like.
  721.       But if you change the name of the .Com screen, be sure to edit
  722.       your batch file to reflect the new file name.
  723.                                                                       
  724.  
  725.  
  726.       CHOOSING COLORS                                               13
  727.       ===============
  728.  
  729.       Finally, once you tell MM how to save your batch file, it'll
  730.       display your menu screen and give you a chance to choose colors.
  731.  
  732.  
  733.       By default, MM creates menus with:
  734.  
  735.        * a shadowed window drawn in White on Blue
  736.  
  737.        * a single-line border around the window
  738.  
  739.        * a green backdrop (to highlight the blue window)
  740.  
  741.  
  742.       You may change any one of these, all of them, or any combination.
  743.       To do so, just press the cursor pad keys (the bottom of your
  744.       screen will have instructions).  As you press the cursor pad
  745.       keys, you'll see your menu change.
  746.  
  747.        * Press the arrow keys to change the colors of the menu window
  748.          itself.
  749.  
  750.          - Up/Down switches among 15 different foreground colors.
  751.  
  752.          - Left/Right switches among 8 background colors.
  753.  
  754.  
  755.        * Press Home or End to change the border style.  There are
  756.          5 alternatives.  Try them all to see which you prefer.
  757.  
  758.  
  759.        * Press PgUp or PgDn to change the color of the backdrop.
  760.  
  761.          One of the options is black.  If you choose this, you'll
  762.          see no backdrop AND no shadow under the menu window (since
  763.          the shadow needs a colored backdrop to be visible).
  764.  
  765.  
  766.       NOTE:  The menu options themselves are printed in white on
  767.       black.  We highlight them using "reverse video" (black on
  768.       white).
  769.  
  770.        * We chose these simple colors to ensure that the actual
  771.          menu choices would be visible on ANY monitor.
  772.  
  773.        * But if you prefer different colors, you must use the <D>raw
  774.          option (not the .Com screen option), then edit the batch
  775.          file and change the colors Sparkle uses to display text.
  776.  
  777.  
  778.       Press <Escape> when you like what you see.  MM will then save
  779.       both your screen and your batch file to disk. 
  780.  
  781.                                                                        
  782.  
  783.  
  784.       NOTES and MORE Options                                        14
  785.       ======================
  786.  
  787.       MM creates VERTICAL scrolling bar menus.  But Sparkle can
  788.       create either vertical -OR- scrolling bar menus.  Why can't
  789.       Menu Magic create horizontal menus?  For two reasons.
  790.  
  791.        * First, we offer another program (P-Screen) with which
  792.          you can create virtually any text-mode screen you like.
  793.          You can save these screens to "compressed" .Com screens,
  794.          or to "screen libraries" or to ASCII files.  P-Screen's
  795.          ".Com" screens are about 1/2 the size of those MM creates --
  796.          thanks to it's screen compression.
  797.  
  798.           - If you save screens to screen libraries or ASCII files,
  799.             you can later load them back into P-Screen to edit them.
  800.  
  801.  
  802.          And P-Screen makes it very easy to add colors, draw lines
  803.          and boxes, add shading, move things around, copy or erase
  804.          things, add Big! Font messages (in over 8 Big! Font styles
  805.          for bold, attention-getting titles), etc.
  806.  
  807.          You can see several of P-Screen's screens if you run
  808.          SP-DEMO.Bat.  This will also demonstrate Sparkle's other
  809.          menu options.
  810.  
  811.  
  812.        * Second, we wanted to keep Menu Magic small, fast and to-the-
  813.          point.  Since vertical bar menus are the most popular and
  814.          flexible type of scrolling bar menus, and since we didn't
  815.          want to duplicate the capabilities that already exist in
  816.          P-Screen, we built MM to offer the most widely used option.
  817.  
  818.  
  819.                                                    continued . . .
  820.                                                                      
  821.  
  822.  
  823.       Notes (continued)                                             15
  824.  
  825.  
  826.       Menu screens DON'T mention <Escape>!  The menu screens that MM
  827.       creates do NOT mention that you can press <Escape> to exit al-
  828.       together -- but that option exists.
  829.  
  830.        * Once Sparkle turns your screen into a bar menu and takes
  831.          over, you must select an option -OR- press <Escape> to exit.
  832.  
  833.        * But what should we do if users press <Esc>?  We weren't sure
  834.          what YOU'D want to do, so we don't mention it.
  835.  
  836.        * Some people create menus with an explicit option to "Quit."
  837.          Others prefer to use <Escape> as the Quit key.  If you'd like
  838.          users to know they can press <Escape> to do something: display
  839.          a message (using "Echo" or Sparkle's "Quick Print" option) to
  840.          tell users to press <Escape> to quit.
  841.  
  842.       MM lets you enter up to 8 menu options -- allowing us to dis-
  843.       play options attractively, without crowding.  But if you need
  844.       more than 8 options, you have several choices.
  845.  
  846.       First, note that Sparkle can handle up to 25 menu options on each
  847.       screen.  And Sparkle can also create horizontal scrolling bar menus.
  848.  
  849.        * Or, use Sparkle's "ASK" option to turn ANY screen (text -OR-
  850.          graphics) into a menu.  Just display a screen telling users
  851.          to press a key to make a choice.  Then run Sparkle and tell
  852.          it which keys the user is allowed to press.  When the user
  853.          presses one of those keys, Sparkle will exit, telling you
  854.          which key was pressed (by setting the DOS errorlevel).
  855.  
  856.       In other words, Sparkle can turn ANY screen into a menu.  You
  857.       don't necessarily need MM to create the screen for you.  And,
  858.       if you need more than 8 menu options you can:
  859.  
  860.        1.  Include, on your menu, the option to go to another menu,
  861.            which can display up to 8 more choices.  There's no limit
  862.            to the number of menus you can have.  And each menu can
  863.            branch to another menu -- the first one going forward, and
  864.            subsequent menus offering options to go to the next menu
  865.            or back to the last one.  If you use this option, you'll
  866.            use MM to create 2 or more batch files.  Then merge them
  867.            together into one batch file.
  868.  
  869.        2.  Create your menu screen in other ways.
  870.  
  871.            * Use the ECHO command in batch files to display your menu.
  872.  
  873.            * Use Sparkle's Window and Quick Print options to display
  874.              your menu -- with windows, shadows and colors if you like.
  875.  
  876.            * Or use our P-Screen program to create any screen you like.
  877.              P-Screen lets you save screens to screen libraries or ASCII
  878.              files, which you can later edit.                          
  879.  
  880.  
  881.       ===================================================================                                                                  
  882.                           Quick Start:  Using Sparkle                16
  883.       ===================================================================
  884.  
  885.       Experiment!  Sparkle is fun!  Experiment with different options,
  886.       sounds and colors.  For a list of options and explanations, enter:
  887.       Sparkle <Enter>   Here's what Sparkle will display:
  888.  
  889.          Sounds  Sparkle  1  # #2  (# = 1 to 35, 88 or 99; #2 = # of times)
  890.        Bar Menu  Sparkle  2  TopRow LftCol BotRow RhtCol Color Direction
  891.             Ask  Sparkle  3  Row Column Color /ValidKeys /Text
  892.       Big! Font  Sparkle  4  Row Column Color CharacterCode /Text
  893.       QuikPrint  Sparkle  5  Row Column Color /Text
  894.          Window  Sparkle  6  TopRow LftCol BotRow RhtCol Color Frame /Text
  895.           Pause  Sparkle  7  HowLong (optional:  99 = allow interrupt)
  896.         Monitor  Sparkle  8  (optional: 99; Errorlevel = 1 if mono monitor)
  897.  
  898.       Choosing Options
  899.       ================
  900.       Each option has a number.  And each option also has sub-options
  901.       (or instructions) you must send Sparkle.  In general, run Sparkle
  902.       like this:    Sparkle Option# x1 x2 x3 x4 ..... <enter>
  903.  
  904.            Where:   Option# is a number from 1 - 8 (1=Sound, 2=Menu, etc.)
  905.  
  906.                     x1, x2 ... etc. are sub-options or instructions
  907.  
  908.           Notice:   * A space MUST separate each item on the command line.
  909.                     * Where we need numbers, send us only numbers (not A-Z).
  910.                     * Whenever you send us text, you MUST begin it with
  911.                       "/" -- see the examples below.
  912.  
  913.            Color:   Several options require a Color -- a number from 1-254
  914.                     telling us which foreground AND background color to use.
  915.                     See "Calculating Color" for tips on choosing colors.
  916.  
  917.       Errorlevel:   Some options return a DOS Errorlevel.  See "Testing
  918.                     Errorlevels" and the description of each option.
  919.       Examples:
  920.       =========
  921.       Sound         Sparkle 1 14
  922.  
  923.                     1 = Option #1 Sound Effects.  14 = the 14th sound.
  924.  
  925.       Big! Font     Sparkle 4 1 1 112 219 /Big! Font
  926.  
  927.                     4 = print a Big! Font message.  Other items tell us
  928.                     where to print it, what color to use, which character
  929.                     to "construct" your message with, and what to print.
  930.  
  931.       Ask           Sparkle 3 25 35 15 /123 /Press 1, 2 or 3
  932.  
  933.                     3 = Ask (print a message or prompt and wait for a
  934.                     key).  Other instructions tell us where to print it,
  935.                     what color to use, and what message to print.
  936.                                                                        
  937.  
  938.  
  939.                            Option 1:   SOUND EFFECTS                17
  940.       =================================================================
  941.  
  942.       To use:   Sparkle  1  # #2  (# = 1 to 35, 88 or 99) (#2 = # of times)
  943.  
  944.       Purpose:  To give you over 35 simple to complex sound effects.
  945.  
  946.                 To repeat the sound effect "#2" of times (-or- until you
  947.                 press a key).   This is optional; you can omit #2.
  948.  
  949.                  * Sound #88 = a ringing phone
  950.                  * Sound #99 = part of the William Tell Overture
  951.  
  952.       Examples:
  953.  
  954.          Sparkle 1  99
  955.                  ^  ^
  956.                  |  }"99" means play part of the William Tell Overture
  957.                  |
  958.                  }option 1 (Sound Effects)
  959.  
  960.           Replace "99" with 88 or a number from 1 to 35 indicating which
  961.           sound you want.  Numbers 6 through 14 offer compound sounds --
  962.           trills, "Oh Oh," etc.  Other numbers are simple tones of
  963.           various durations.
  964.  
  965.  
  966.          Sparkle 1  6  15
  967.                  ^  ^  ^
  968.                  |  |  }repeat the sound 15 times, or until a key is pressed
  969.                  |  |
  970.                  |  }sound effect #6
  971.                  |
  972.                  }option 1 (Sound Effects)
  973.  
  974.           If you include a "repeat number," Sparkle play the sound, then
  975.           repeats it # times (for a total of 16 in this example).  You
  976.           can press a key at any time to stop.  Between each sound effect,
  977.           Sparkle pauses just a little to ensure the sounds don't blend
  978.           into one.  Sounds 88 and 99 cannot be repeated.
  979.  
  980.           You can repeat a sound up to 9,999 times!  This effectively means
  981.           that Sparkle will continue until you press a key -- which is what
  982.           Mark Dodd of Texas asked for.  Depending on the sound you chose,
  983.           9,999 times could mean a few minutes, a few hours or a few days.
  984.  
  985.             * Remember, you can press a key to stop!
  986.             * But you'd better tell your users that.
  987.  
  988.  
  989.       NOTE:  Sparkle checks to see what type of CPU is being used.  It
  990.              does this to ensure sounds are comparable regardless of
  991.              whether an 8088, 286, 386 or 486 PC is used.  In other
  992.              words, the sounds should be similar regardless of how fast
  993.              the PC is.  But speakers will affect sounds.
  994.                                                                        
  995.  
  996.  
  997.                         Option 2:  SCROLLING BAR MENUS              18
  998.       =================================================================
  999.  
  1000.       To use:   Sparkle 2 TopRow LeftCol BotRow RightCol Color Direction
  1001.  
  1002.       Purpose:  To turn ANY text (not graphics) screen into a Vertical
  1003.                 or Horizontal scrolling bar menu.  Here's what you do:
  1004.  
  1005.       1. Display a screen.  You can use Sparkle's Window and Quick Print
  1006.          options to create a menu.  You can "echo" text in a batch file.
  1007.          Or "run" a P-Screen "Com" screen and blast your screen up.
  1008.          
  1009.  
  1010.       2. Then run Sparkle like this:
  1011.  
  1012.              Sparkle 2 TopRow LftCol BotRow RhtCol Color Direction
  1013.  
  1014.          Where:
  1015.              - "2" = Option 2 (the bar menu option)
  1016.  
  1017.              - TopRow, LeftCol, BotRow, RightCol indicate the location of
  1018.                your menu on the screen (tell us where menu options are).
  1019.  
  1020.              - Color is a number from 1-127 (usually) indicating the
  1021.                color we should use to HIGHLIGHT menu options.  If zero,
  1022.                we'll use 112 (black on white).  See "Calculating Color"
  1023.                for a chart that can help you determine this number.
  1024.  
  1025.              - Direction = 1 (vertical menu) or 2 (horizontal menu)
  1026.  
  1027.              NOTE:  To determine TopRow, LeftCol, BotRow and RightCol:
  1028.                     1) Run "Ruler.Exe" -- our RAM-resident ruler.
  1029.                        With your menu screen visible, call up Ruler.
  1030.                        Move the cursor to the top left corner of your
  1031.                        menu; note the Row/Column.  Now move to the
  1032.                        bottom, right corner.  Note the Row/Column.
  1033.  
  1034.                     2) Manually count rows and columns.
  1035.  
  1036.       3. Test Errorlevel.   (See "A Note About Testing Errorlevels")
  1037.  
  1038.          Sparkle returns a DOS Errorlevel indicating which option was
  1039.          selected.  Interpret the Errorlevel like this:
  1040.  
  1041.          1 to x    = The number of the option chosen (1 = the 1st option,
  1042.                      2 = 2nd option..... x = last option)
  1043.           27       = Esc was pressed
  1044.           88 or 99 = Either your screen location variables were "wrong"
  1045.                      (eg., Top Row <<greater than>> Bottom Row).
  1046.  
  1047.                      Or we found no TEXT / Menu Choices in the area
  1048.                      of the screen where you said your menu would be.
  1049.  
  1050.                                                                        
  1051.  
  1052.  
  1053.      Scrolling Bar Menus (continued)                               19
  1054.      ==================================================================
  1055.  
  1056.          Sparkle 2  5 45  20 78 79 1
  1057.                  ^  ^ /   ^ /   |  ^
  1058.                  |  |/    |/    | }It's a Vertical menu (choices up/down)
  1059.                  |  |     |     |
  1060.                  |  |     |     }Highlight menu options in White on Red
  1061.                  |  |     |
  1062.                  |  |     }menu ends on row 20, column 78
  1063.                  |  |
  1064.                  |  }menu starts on row 5, column 45
  1065.                  |
  1066.                  }option 2 (Menu)
  1067.  
  1068.       IMPORTANT NOTES on Creating Bar Menus: : : :
  1069.       ============================================
  1070.  
  1071.        1.  Once you define the "coordinates" of a menu screen, we scan
  1072.            the screen looking for "menu text."  We ignore blank lines
  1073.            and lines with only "graphics" (lines, boxes or shading).
  1074.  
  1075.            - ANY text found inside the screen coordinates WILL be
  1076.              considered menu text -- UNLESS you begin that line of text
  1077.              with Chr$(255) (ASCII character #255).  Use 255 to tell
  1078.              us to ignore lines inside your window that explain what
  1079.              the user should do, that introduce something, etc.
  1080.  
  1081.              You can enter character 255 in two ways:
  1082.  
  1083.              a) Create your screen with our P-Screen program.  Move the
  1084.                 cursor to the beginning of each line of text you want us
  1085.                 to ignore.  Press Alt-J to display the "Join" window.
  1086.                 Move the cursor to the last character in the window
  1087.                 (it'll look blank).  Press <Enter> to accept it.
  1088.  
  1089.              b) Most word processors or editors let you enter "High
  1090.                 ASCII" characters.  Load your menu screen into your word
  1091.                 processor.  Move the cursor to the beginning of each
  1092.                 line of text you want us to ignore.  Hold down the Alt
  1093.                 key and enter 255 on the NUMERIC KEYPAD of your keyboard
  1094.                 (DON'T use the numbers at the top of your keyboard.
  1095.  
  1096.              Character 255 is NUL or Blank.  It looks just like a blank
  1097.              space on your screen.  In P-Screen you can "paint" it any
  1098.              color you want, or you can move, copy or delete it.
  1099.  
  1100.        2.  In Horizontal menus, use character 255 to "link" 2 or more
  1101.            words that are part of the same menu option.  For example:
  1102.  
  1103.                   Lotus 123    Paradox    WordPerfect   Quit
  1104.  
  1105.            - This menu has 4 options.  But notice the space between
  1106.              "Lotus" and "123".  If we don't plug that space with char-
  1107.              acter 255 (or a hyphen), Sparkle WILL treat "123" as a menu
  1108.              option -- giving us 5 not 4 options.                        
  1109.                                                                             
  1110.  
  1111.       Important Notes on Scrolling Bar Menus (continued)           20
  1112.       =================================================================
  1113.  
  1114.        3.  In VERTICAL menus, each line should be a single menu choice.
  1115.  
  1116.             * Each line can have as many words on it as you like (and
  1117.               you needn't fill blanks between words with character 255).
  1118.  
  1119.             * If your menu options need 2 or more lines, start the 2nd,
  1120.               3rd, etc. line with character 255 -- so we'll ignore them.
  1121.  
  1122.  
  1123.        4.  In HORIZONTAL menus, ALL menu options must be on a single
  1124.            line.  And the first line of text we find that doesn't begin
  1125.            with character 255 will be treated as your menu line.  NOTE:
  1126.            TopRow and BotRow are normally the same for horizontal menus.
  1127.  
  1128.  
  1129.        5.  Sparkle HIGHLIGHTS menu choices using the color you specify.
  1130.  
  1131.            To ensure the highlight is visible, BE SURE to use a color
  1132.            that contrasts with the basic colors of your menu.  If you
  1133.            don't, the menu highlight will be hard or impossible to see.
  1134.            For example, if your menu is blue or red (ie., dark), try 112
  1135.            (black on white).  But if your menu is light (cyan, white,
  1136.            yellow, etc.), consider a red (79) or blue (31) highlight.
  1137.  
  1138.            See "Calculating Colors" for a chart that can help you choose
  1139.            a "color number."
  1140.  
  1141.            NOTE:  In an earlier version of Sparkle we highlighted menu
  1142.            option by reversing the colors.  This seemed to simplify your
  1143.            task since you didn't have to tell us what color to use.  BUT,
  1144.            we got reports that these reversed colors were invisible on
  1145.            some monitors.  So we returned to the earlier approach (speci-
  1146.            fying a color) to give you greater safety and flexibility.
  1147.  
  1148.  
  1149.        6.  To select options in bar menus using a MOUSE:
  1150.  
  1151.             * Click the LEFT button on an option to highlight that option.
  1152.  
  1153.             * DOUBLE click the LEFT button on an option to select it.
  1154.  
  1155.             * Sparkle uses only the left mouse button (and ignores others).
  1156.                                                                            
  1157.  
  1158.        7.  To select options in bar menus using the KEYBOARD:
  1159.  
  1160.             * Highlight an option then press <cr> to accept it.
  1161.  
  1162.             * To highlight options, press the Up or Down cursor keys,
  1163.               or press the first letter of the option you want.  If
  1164.               2 or more options begin with the same first letter, keep
  1165.               pressing that letter until we highlight the option you want.
  1166.                                                                            
  1167.  
  1168.  
  1169.                                Option 3:  ASK                      21
  1170.       =================================================================
  1171.  
  1172.       To Use:   Sparkle  3  Row Column Color /ValidKeys /Text
  1173.  
  1174.       Purpose:  ASK lets you treat ANY screen as a menu screen.  Or use
  1175.                 ASK just to pause until users press a key.  You can:
  1176.  
  1177.                 1) display a message anywhere on the screen (text mode only)
  1178.                 2) display it in whatever color you want
  1179.                 3) wait for the user to press one of the keys you specified,
  1180.                    then report an Errorlevel indicating which key was
  1181.                    pressed.  (See "A Note About Testing Errorlevels")
  1182.  
  1183.        YOU specify which keys we should exit on (Sparkle also exits if
  1184.        Escape is pressed).  For example, say you display a menu and ask
  1185.        the user to choose an option by pressing 1, 2, 3, 4 or Q to Quit.
  1186.         - Just tell us the Valid Keys are 1234Q.
  1187.  
  1188.         - If Valid Keys is NULL (Empty or Nothing), we'll wait until
  1189.           ANY KEY is pressed, then exit with Errorlevel set to 0.
  1190.  
  1191.        Example:
  1192.  
  1193.           Sparkle 3 25 35 112 /1234q /Please press 1, 2, 3, 4 or [Q]uit
  1194.                   ^  ^ /  ^   ^      ^
  1195.                   |  |/   |   |      }print the message beginning with "/"
  1196.                   |  |    |   |
  1197.                   |  |    |   }wait until user presses one of these keys
  1198.                   |  |    |
  1199.                   |  |    }print in color 112 (black on white)
  1200.                   |  |
  1201.                   |  }print on Row 25, Column 35
  1202.                   |
  1203.                   }option 3 (ASK)
  1204.  
  1205.       NOTES on Ask
  1206.       ============
  1207.  
  1208.        - If ValidKeys AND Text are both blank, Sparkle prints nothing
  1209.          and just waits until the user presses ANY key.
  1210.  
  1211.        - Sparkle sets the DOS Errorlevel to indicate which key was pressed.
  1212.          -- 27 means Escape was pressed.
  1213.          -- Otherwise it's the Ascii code of the key pressed. APPENDIX I
  1214.             lists the Ascii codes for many keyboard characters.
  1215.          -- See "Notes on Testing Errorlevels" for examples of how to
  1216.             deal with these.
  1217.  
  1218.        - IMPORTANT:
  1219.          -- You MUST use a backslash (/) to begin BOTH your
  1220.             list of valid keys AND the text to be printed.
  1221.  
  1222.          -- We treat user key presses in upper case (ie., we don't
  1223.             distinguish a from A).  But your list of Valid Keys
  1224.             can be in upper or lower case (or both).                   
  1225.  
  1226.  
  1227.  
  1228.         ▌▌▌▌▌▌   ▌▌▌▌  ▌▌▌▌▌   ▐▐     ╬╬╬╬╬╬╬                    ╪╪   22
  1229.          ▌▌  ▌▌   ▌▌  ▌▌   ▌▌  ▐▐      ╬╬   ╬                    ╪╪
  1230.          ▌▌  ▌▌   ▌▌  ▌▌   ▌▌  ▐▐      ╬╬ ╬    ║║║║║   ││││││  ╪╪╪╪╪╪
  1231.          ▌▌▌▌▌    ▌▌  ▌▌       ▐▐      ╬╬╬╬   ║║   ║║  ││   ││   ╪╪
  1232.          ▌▌  ▌▌   ▌▌  ▌▌ ▌▌▌▌  ▐▐      ╬╬ ╬   ║║   ║║  ││   ││   ╪╪
  1233.          ▌▌  ▌▌   ▌▌  ▌▌   ▌▌          ╬╬     ║║   ║║  ││   ││   ╪╪
  1234.         ▌▌▌▌▌▌   ▌▌▌▌  ▌▌▌▌▌   ▐▐     ╬╬╬╬     ║║║║║   ││   ││   ╪╪╪╪
  1235.       ==================================================================
  1236.  
  1237.       To Use:   Sparkle  4  Row Column Color CharacterCode /Text
  1238.  
  1239.       Purpose:  Big! Font, turns your message into one 7-8 lines high.
  1240.                 Each character will be 8 columns wide.  You can:
  1241.  
  1242.                 - display a Big! Font message anywhere on the screen
  1243.                 - display it in whatever color you want
  1244.                 - "build" your message using ANY ASCII character
  1245.  
  1246.       (If you printed this and your printer can't print the high ASCII
  1247.       characters, the Big! Font message is probably a mess.  Sorry.  But
  1248.       if you're browsing through this on your PC, you can see how drama-
  1249.       tic Big! Font messages can be.  And Sparkle gives you color as well.)
  1250.  
  1251.       Example:
  1252.  
  1253.             Sparkle 4  9  1 12  219 /Hi There !
  1254.                     ^  ^ /  ^   ^      ^
  1255.                     |  |/   |   |      }print the message beginning with "/"
  1256.                     |  |    |   |
  1257.                     |  |    |   }"Build" characters using ASCII character 219
  1258.                     |  |    |
  1259.                     |  |    }print in color 12 (Bright Red on Black)
  1260.                     |  |
  1261.                     |  }begin printing on Row 9, Column 1
  1262.                     |
  1263.                     }option 4 (Big! Font)
  1264.  
  1265.       NOTES on Big! Font
  1266.       ==================
  1267.        * Since each character will be 8 columns wide, only 10 Big! Font
  1268.          characters will fit on 80-column screens.
  1269.  
  1270.        * "Row" is the TOP row on which to begin printing.  Most Big!
  1271.          Font characters will have 7 lines.  But characters with descen-
  1272.          ders (such as lower case g, y, q, p, etc.) also need the 8th line.
  1273.          - Be sure to specify a Row at least 7 lines above the bottom of
  1274.            your screen -- or you won't see the bottom of the characters.
  1275.          - Sparkle WILL print on 43 or 50 line screens.
  1276.  
  1277.        * We'll "build" characters using any ASCII character you specify.
  1278.          If you specify "0" we'll build each character using THAT char-
  1279.          acter (ie., we'll build a "G" with Gs, an "X" with Xs, etc.).
  1280.          - Use 219 - 223 for bold, solid or "striped" characters.
  1281.          - Use 1 or 2 for "happy faces," 176 - 178 for shaded characters.
  1282.          - ANY ASCII character from 1 to 254 will work.                    
  1283.  
  1284.  
  1285.  
  1286.  
  1287.                             Option 5:  QUICK PRINT                 23
  1288.       =================================================================
  1289.  
  1290.        To use:   Sparkle  5  Row Column Color /Text
  1291.  
  1292.        Purpose:  Quickly print text anywhere on your screen in any color.
  1293.                  You can print ANY Ascii character from 1-255 -- you're
  1294.                  not limited to printing normal keyboard characters.
  1295.  
  1296.        Example:
  1297.  
  1298.             Sparkle 5  25 25  112  /Good Morning
  1299.                     ^   ^ /   ^    ^
  1300.                     |   |/    |    }print the message beginning with "/"
  1301.                     |   |     |
  1302.                     |   |     }print in color 112 (black on white)
  1303.                     |   |
  1304.                     |   }begin printing on Row 25, Column 25
  1305.                     |
  1306.                     }option 5 (Quick Print)
  1307.  
  1308.                                                                        
  1309.  
  1310.  
  1311.                              Option 6:  WINDOWS                    24
  1312.       =================================================================
  1313.  
  1314.        To Use:   Sparkle  6  TopRow LftCol BotRow RhtCol Color Frame /Text
  1315.                  Sparkle -6  Draws an EXPLODING window (all else the same)
  1316.                              Exploding windows GROW to the size you specify.
  1317.  
  1318.        Purpose:  Quickly create windows (or boxes) on the screen.
  1319.                  - Choose from over 250 frame styles!!!
  1320.                  - Windows can have shadows (or not) and can use any color
  1321.                  - You can include text or a title, centered on the top row
  1322.  
  1323.        Frame     Sparkle offers over 250 frame styles.  Select these by
  1324.        styles:   setting Frame = 1 to 255.  Styles 1-5 include:
  1325.  
  1326.                    1 = Single line all around                        (┌)
  1327.                    2 = Double line all around                        (╔)
  1328.                    3 = Double line horizontal, single line vertical  (╒)
  1329.                    4 = Double line vertical, single line horizontal  (╓)
  1330.                    5 = Bolder solid line                             (▐▀)
  1331.                    6 = DON'T use.  This is meant only for multiple
  1332.                        colors which Sparkle presently can't handle.
  1333.  
  1334.                  If you set Frame to any OTHER number from 7-255, Sparkle
  1335.                  draws your window in that ASCII character.  For example,
  1336.  
  1337.                    219 = Bold solid line                             (█)
  1338.                      7, 249 or 250 = dots of various sizes  (can't show here)
  1339.                     61 = The equal sign "="
  1340.                     86 = The letter "V"
  1341.                     etc.... you get the idea.  Experiment!
  1342.  
  1343.        Titles:   Sparkle prints "/Text" (your title or message) centered
  1344.                  on the top row of your window.
  1345.  
  1346.        Shadow:   To request a "drop shadow" for your window, send Sparkle
  1347.                  a NEGATIVE frame number (eg., -2).
  1348.                  - Shadows are printed right of and below your window.
  1349.                  - Be sure to allow for TWO extra columns on the right,
  1350.                    and ONE extra row on the bottom of shadowed windows.
  1351.  
  1352.        Frameless  NOTE:  ASCII characters 32 and 255 are blank.  If you
  1353.        Windows:   create "windows" with these, you'll get a frameless
  1354.                   splash of color!  Specify Frame = -32 or -255 to get
  1355.                   a shadowed splash of color!
  1356.  
  1357.        Example:
  1358.  
  1359.             Sparkle -6  5  7 20  75  79 -1  /My Window
  1360.                     ^  ^  /  ^  /   ^   ^  ^
  1361.                     |  | /   | /    |   |  }Print this title/message
  1362.                     |  |/    |/     |   }Frame style 1 AND shadowed (negative)
  1363.                     |  |     |      }Use color 79 (White on Red)
  1364.                     |  |     }Window ends on row 20, column 75 (shadow below)
  1365.                     |  }Window starts on row 5, column 7 (shadow on right)
  1366.                     }option -6 (Exploding Window)                      
  1367.  
  1368.  
  1369.  
  1370.                              Option 7:  PAUSE                      25
  1371.       =================================================================
  1372.  
  1373.        To Use:   Sparkle  7  HowLong  Interrupt (optional)
  1374.  
  1375.        Purpose:  Allow batch files to pause briefly, and then continue.
  1376.                   - You can specify pauses from 1/3 second to several
  1377.                     minutes.
  1378.                   - You can also let user "interrupt" or bypass the
  1379.                     pause and go on.  This is optional.
  1380.  
  1381.        Examples:
  1382.  
  1383.             Sparkle 7  12
  1384.                     ^  ^
  1385.                     |  |
  1386.                     |  }Pause for 4 seconds (each # = 1/3 second)
  1387.                     |
  1388.                     }option 7 (Pause)
  1389.  
  1390.  
  1391.             Sparkle 7  15  99
  1392.                     ^  ^   ^
  1393.                     |  |   |
  1394.                     |  |   }Pause, but let user "press a key" to go on
  1395.                     |  |
  1396.                     |  }Pause for 5 seconds (each # = 1/3 second)
  1397.                     |
  1398.                     }option 7 (Pause)
  1399.  
  1400.       NOTES on Pause
  1401.       ==============
  1402.  
  1403.        * "HowLong" is measured in 1/3 second increments.  "12" tells
  1404.          Sparkle to pause 4 seconds (12/3 = 4).  Similarly, "15" means
  1405.          pause 5 seconds (15/3 = 5).
  1406.          - An easy way to decide what number to use is to decide how
  1407.            many SECONDS you want to pause, then MULTIPLY that by 3.
  1408.  
  1409.        * To let users "press a key" to interrupt the pause and move on,
  1410.          send Sparkle 2 numbers:  HowLong AND 99.   For example:
  1411.  
  1412.             Sparkle 7 6 99.
  1413.  
  1414.        * Sparkle checks to see what type of CPU is being used -- to
  1415.          ensure pauses are the same regardless of whether an 8088, 286
  1416.          386 or 486 PC is used.
  1417.          - HOWEVER, the speed of the disk drive WILL affect the pause.
  1418.            That's because Sparkle must load first, and then pause.
  1419.          - Although Sparkle is small and loads quickly, floppy disks can
  1420.            be 10-15 times SLOWER than hard disks.  If your batch files
  1421.            will run off of different types of disks, test them on
  1422.            different disk drives to determine the length of a pause
  1423.            that's a "happy medium" on all drives.
  1424.                                                                        
  1425.  
  1426.                              Option 8:  MONITOR                    26
  1427.       =================================================================
  1428.  
  1429.        To Use:   Sparkle  8  (optional 99; Errorlevel = 1 if mono monitor)
  1430.  
  1431.        Purpose:  Report what type of display adapter AND monitor is active.
  1432.                  - This is handy to decide which colors to use in batch files.
  1433.                  - This is also handy to start presentations using our
  1434.                    P~F Presents program.  Run presentations in Color or
  1435.                    in "monochrome" based on the type of monitor being used.
  1436.  
  1437.        Example:
  1438.  
  1439.             Sparkle 8
  1440.                     ^
  1441.                     |
  1442.                     }option 8 (Monitor)
  1443.  
  1444.             Sparkle 8  99
  1445.                     ^  ^
  1446.                     |  |
  1447.                     |  }Set Errorlevel=1 if a monochrome monitor is detected
  1448.                     |   (regardless of the type of display adapter present)
  1449.                     |
  1450.                     }option 8 (Monitor)
  1451.  
  1452.       NOTES on Monitor
  1453.       ================
  1454.  
  1455.        * Option 8 tells Sparkle to set the DOS Errorlevel based on BOTH
  1456.          the type of display adapter AND monitor detected.
  1457.  
  1458.          Run Sparkle with NO options (ie., Sparkle 8), and it sets the
  1459.          Errorlevel as follows:
  1460.  
  1461.             1 = Monochrome adapter            2 = Hercules adapter
  1462.             3 = CGA adapter
  1463.             4 = EGA adapter/Mono monitor      5 = EGA adapter/Color monitor
  1464.             6 = VGA adapter/Mono monitor      7 = VGA adapter/Color monitor
  1465.             8 = MCGA adapter/Mono monitor     9 = MCGA adapter/Color monitor
  1466.            10 = EGA adapter/CGA monitor      11 = IBM 8514/A adapter
  1467.  
  1468.        * NOTE that options 1, 4, 6 and 8 ALL indicate a monochrome
  1469.          monitor is active.  If all you need to know is whether the
  1470.          monitor is Color or Mono, run Sparkle like this:   Sparkle 8  99
  1471.  
  1472.           - "99" tells Sparkle to set the Errorlevel to 1 if a mono monitor
  1473.             is detected (ie., if Sparkle would normally report 1, 4, 6 or 8).
  1474.  
  1475.           - This can simplify testing Errorlevels to something like:
  1476.  
  1477.               If Errorlevel 3 goto ItsColor   'If greater than or equal to 3..
  1478.               Goto ItsMonochrome              'Otherwise, assume it's mono.
  1479.  
  1480.        SEE THE NEXT PAGE for examples of how you can use Option 8 to set
  1481.        options "on the fly" in batch files.
  1482.                                                      continued . . .   
  1483.  
  1484.  
  1485.        Option 8 MONITOR  (continued)                               27
  1486.  
  1487.  
  1488.        Two DOS features ("named parameters" and SET) can help you
  1489.        customize your batch files -- depending on the type of monitor
  1490.        Sparkle tells you is active.  (These features may not be
  1491.        available with all DOS versions.)
  1492.  
  1493.        "Named parameters" let you define "variables" you can use later
  1494.        in your batch files.  Basically, you:
  1495.  
  1496.         * Use the DOS SET command to set variable(s) to specific values
  1497.           (eg., SET ErrSound=12, or SET MyColor=15, or SET HiLite=112).
  1498.  
  1499.         * Run Sparkle and use variable NAMES rather than values
  1500.           (eg., Sparkle 1 ErrSound).
  1501.  
  1502.  
  1503.        Here's an example.  Notice how we:
  1504.  
  1505.          1.  Run Sparkle to see if a color monitor is being used.
  1506.  
  1507.          2.  Depending on the type of monitor detected (color or mono),
  1508.              we SET a variable called "WhichClr" to a color appropriate
  1509.              for that monitor.
  1510.              -- "WhichClr" will now be available to every other line in
  1511.                 our batch file -- as long as we use the variable name.
  1512.  
  1513.          3.  We then use the variable NAME to tell Sparkle which color
  1514.              to print with.
  1515.              -- NOTICE that when we use the variable when running
  1516.                 Sparkle, we place it between two percent signs (eg.,
  1517.                 %WhichClr%).  This is REQUIRED!
  1518.  
  1519.  
  1520.             sparkle 8 99                       '"99" since we only need to
  1521.                                                'know if it's color or mono
  1522.  
  1523.             If Errorlevel 3 goto _PrtInColor   'if 3 or higher, it's color
  1524.  
  1525.             Set WhichClr=112                   'If 1 or 2, it's a
  1526.                                                'monochrome monitor; use
  1527.                                                'simple Black on White.
  1528.  
  1529.             Sparkle 5 21 15 %WhichClr% / MONOCHROME monitor detected
  1530.  
  1531.             goto (somewhere to jump over the Color section)
  1532.  
  1533.             :_PrtInColor
  1534.  
  1535.             Set WhichClr=78                     'It's color, SET "WhichClr"
  1536.                                                 'to 78  (Yellow on Red).
  1537.  
  1538.             Sparkle 5 21 15 %WhichClr% / COLOR monitor detected
  1539.  
  1540.                                                                        
  1541.  
  1542.  
  1543.                         A NOTE ON TESTING Errorlevels              28
  1544.       =================================================================
  1545.       Also see APPENDIX I:  ASCII Codes for many keyboard characters.
  1546.  
  1547.       Always test Errorlevels from the HIGHEST number to the LOWEST.
  1548.       This is a DOS restriction.  For example:
  1549.              If Errorlevel 2 goto no         \   this sequence
  1550.              If Errorlevel 1 goto yes        /   is correct
  1551.  
  1552.              If Errorlevel 1 goto yes        \   this sequence
  1553.              If Errorlevel 2 goto no         /   is WRONG
  1554.  
  1555.       Here's why this is important.  DOS tests the phrase:
  1556.  
  1557.                     If Errorlevel 1 goto yes
  1558.  
  1559.       as if it read "If Errorlevel greater-than-or-equal-to 1 goto Yes."
  1560.  
  1561.       So, if you start testing with "If Errorlevel 1 goto Yes" (note
  1562.       "1"), DOS will almost ALWAYS go to "Yes" -- since most everything
  1563.       is "greater-than-or-equal-to 1".
  1564.  
  1565.       Examples:
  1566.       =========
  1567.  
  1568.       Here's an example from Sparkle's demo batch file (SP-Demo.Bat).
  1569.       We first display a bar menu.  We then test to see which option was
  1570.       chosen.  Note that we first test for Escape (Ascii code 27).  Bar
  1571.       menus return the NUMBER of the option chosen.  Our main menu had 5
  1572.       choices.  We first test for Escape, since 27 is higher than 5.  We
  1573.       then test for which option was chosen with "If Errorlevel 5 ...."
  1574.  
  1575.           :_MainMenu
  1576.           Sparkle  2  5 5 5 76 112 2
  1577.           If Errorlevel 27 goto _End
  1578.           If Errorlevel 5  goto _End
  1579.           If Errorlevel 4  goto _BarMenus
  1580.           If Errorlevel 3  goto _Sounds
  1581.           If Errorlevel 2  goto _Windows
  1582.           If Errorlevel 1  goto _Intro
  1583.           goto _MainMenu                   (just in case tests fail)
  1584.  
  1585.       Here's what a batch file might look like if you used ASK.
  1586.  
  1587.         * NOTE:  Here we test for Escape LAST!!  That's because ASK
  1588.           returns the ASCII value of the key pressed.  The ASCII code
  1589.           for "Y" is 89, the code for "N" is 78.  The code for Escape
  1590.           (27) is LESS than 89 or 78, so we test for it last.
  1591.  
  1592.           :_AskAgain
  1593.           Sparkle 3 25 20 112 /YN /Do you want to go on?  Press [Y]es or [N]o
  1594.           If Errorlevel 89 goto _YesPressed
  1595.           If Errorlevel 78 goto _NoPressed
  1596.           If Errorlevel 27 goto _AskAgain     '--- We'll ONLY accept Y or N!
  1597.           goto _AskAgain                      '--- Ditto for any other key.
  1598.                                                                        
  1599.  
  1600.  
  1601.                          Choosing a COLOR NUMBER                   29
  1602.       ================================================================
  1603.  
  1604.       When we ask you for a color, send us 1 number indicating BOTH
  1605.       Foreground AND Background colors.  Here's how to calculate it:
  1606.       (Tip:  print this page to have a quick reference guide.)
  1607.  
  1608.       Step 1:  In the table below, move your finger DOWN the left column
  1609.                until it's on the FOREGROUND color you want.  Note that
  1610.                the first 8 colors are "normal" intensity.  The next 8
  1611.                are "bright" ("high intensity") versions of the first 8.
  1612.  
  1613.       Step 2:  Now move your finger ACROSS the columns until it's under
  1614.                the BACKGROUND color you want.  Use the number you see
  1615.                there (under your finger).  NOTE that, as you move across
  1616.                the columns, numbers increase by 16.  If you prefer for-
  1617.                mulas to tables:  Color = ForeGround + (Background * 16).
  1618.                Foreground colors range from 0-15; Background from 0-7.
  1619.  
  1620.       Step 3:  OPTIONAL:  For blinking colors, just add 128 to the
  1621.                number you got in step 2.
  1622.  
  1623.                                    BACKGROUND COLORS
  1624.                                    =================
  1625.  
  1626.                     Black  Blue Green  Cyan  Red Magnta Brown White
  1627.                    ---0-----1-----2-----3-----4-----5-----6-----7----
  1628.  
  1629.        F    Black     0    16    32    48    64    80     96   112
  1630.        O    Blue      1    17    33    49    65    81     97   113   N
  1631.        R    Green     2    18    34    50    66    82     98   114   O
  1632.        E    Cyan      3    19    35    51    67    83     99   115   R
  1633.        G    Red       4    20    36    52    68    84    100   116   M
  1634.        R    Magenta   5    21    37    53    69    85    101   117   A
  1635.        O    Brown     6    22    38    54    70    86    102   118   L
  1636.        U    White     7    23    39    55    71    87    103   119
  1637.        N
  1638.        D    Grey      8    24    40    56    72    88    104   120
  1639.             Blue      9    25    41    57    73    89    105   121   B
  1640.        C    Green    10    26    42    58    74    90    106   122   R
  1641.        O    Cyan     11    27    43    59    75    91    107   123   I
  1642.        L    Red      12    28    44    60    76    92    108   124   G
  1643.        O    Magenta  13    29    45    61    77    93    109   125   H
  1644.        R    Yellow   14    30    46    62    78    94    110   126   T
  1645.        S    White    15    31    47    63    79    95    111   127
  1646.  
  1647.       Examples:
  1648.       =========
  1649.              Any color on black background:     1 - 15
  1650.       Black foreground on white background:      112
  1651.          Bright white on a blue background:       31
  1652.                  Black on a red background:       64
  1653.        Blinking black on a cyan background:      176   (48 + 128 = 176)
  1654.  
  1655.                                                                          
  1656.  
  1657.         
  1658.              APPENDIX I:  ASCII Codes for many keyboard characters   30
  1659.              =====================================================
  1660.  
  1661.        Use this chart to design your "If Errorlevel # ...." statements
  1662.        in your batch files.
  1663.  
  1664.        When you use Sparkle's ASK option (to get, for example, the user's
  1665.        choice at a menu), Sparkle sets the DOS Errorlevel equal to the
  1666.        ASCII code of the key that was pressed.
  1667.  
  1668.         * Remember, you tell Sparkle which keys to "accept" (ie., which
  1669.           keys are "valid") by sending it a variable called "valid keys:"
  1670.  
  1671.              Sparkle 3 Row Column Color /ListOfValidKeys /Prompt
  1672.  
  1673.         * ALL letters are treated as UPPER CASE.  That means you can't
  1674.           include, say, both A and a as valid keys.
  1675.  
  1676.         * Note in the chart below that A - Z have ASCII codes of 65 - 90.
  1677.           Numbers 0 - 9 have ASCII codes of 48 - 57.
  1678.  
  1679.  
  1680.           One IMPORTANT IMPLICATION of these numbers is that if you
  1681.           want to test to see if users pressed Escape (ASCII code 27),
  1682.           you MUST test for it LAST.
  1683.  
  1684.           - "Notes on Testing Errorlevels" explains why.
  1685.  
  1686.           - But basically, DOS requires that you you test errorlevels
  1687.             from HIGHEST to LOWEST.  Since 27 (Escape) is LOWER than any
  1688.             of the ASCII codes listed here, you must test for it last.
  1689.  
  1690.                             ASCII                          ASCII
  1691.              Key Pressed    Code             Key Pressed   Code
  1692.              ===========    =====            ===========   =====
  1693.                   A           65                  B          66
  1694.                   C           67                  D          68
  1695.                   E           69                  F          70
  1696.                   G           71                  H          72
  1697.                   I           73                  J          74
  1698.                   K           75                  L          76
  1699.                   M           77                  N          78
  1700.                   O           79                  P          80
  1701.                   Q           81                  R          82
  1702.                   S           83                  T          84
  1703.                   U           85                  V          86
  1704.                   W           87                  X          88
  1705.                   Y           89                  Z          90
  1706.  
  1707.                   0           48                  1          49
  1708.                   2           50                  3          51
  1709.                   4           52                  5          53
  1710.                   6           54                  7          55
  1711.                   8           56                  9          57
  1712.                                                                         
  1713.  
  1714.  
  1715.                  APPENDIX II:   Other Programs by Pro~Formance       31
  1716.          ==============================================================
  1717.  
  1718.          Here's a summary of many of our programs.   Feel free to call
  1719.          us for details or to order.
  1720.  
  1721.          ==============================================================
  1722.          Text Font
  1723.          ==============================================================
  1724.  
  1725.           * Have you ever wanted to replace the dull, ever-same font
  1726.             your PC normally uses to display text?
  1727.  
  1728.           * Would you like **dozens** of alternative text fonts to
  1729.             use as your preferences, needs or moods change?
  1730.  
  1731.           * Have you ever wanted to surprise or amuse friends by dis-
  1732.             playing messages in unusual, dramatic or striking fonts?
  1733.  
  1734.           * Would you like to watch as your boss or a co-worker returns
  1735.             from lunch to find the text on their screen upside down or ???.
  1736.  
  1737.           * Are you visually impaired?  Is someone you know?  Would
  1738.             larger or bolder fonts make it easier to use the PC?
  1739.  
  1740.           * Do you use presentation programs (like our P~F Presents)?
  1741.             Would you like to customize the way messages and text
  1742.             appear on the screen?  Would you like to change text
  1743.             fonts whenever you like?
  1744.  
  1745.           * In batch files or menu programs, would you like to:
  1746.  
  1747.             - Customize the way text and options appear?
  1748.  
  1749.             - Display different types of messages in different fonts?
  1750.               Menu options in one font.  Error messages in another.
  1751.  
  1752.  
  1753.          If you answered "YES" to any of these questions, you'll find
  1754.          Text Font a welcome and valuable addition to your tool kit!
  1755.  
  1756.  
  1757.          On EGA or VGA monitors, Text Font replaces the font all
  1758.          text-mode programs (including DOS) use to display text.  It
  1759.          offers about 50 different fonts!
  1760.  
  1761.           * Try Script, Old English, Medieval, Tall, Bold, or Future.
  1762.  
  1763.           * Or try Hebrew, Cyrillic or Thai.
  1764.  
  1765.           * Or try Reverse, Underlined or Backwards.
  1766.  
  1767.          Text Font even includes a RAM-resident version to ensure YOUR
  1768.          font is preserved even if programs change screen modes.  So, if
  1769.          you run Microsoft Windows, and then return to DOS, the font YOU
  1770.          selected is restored.                                         
  1771.  
  1772.  
  1773.  
  1774.          ==============================================================
  1775.          Professional Scribe (Pro~Scribe)              PS Express (PSE)
  1776.          ==============================================================
  1777.  
  1778.          Pro~Scribe and PSE help you improve anything you write (or help
  1779.          you improve the writing of others -- your staff, students, etc.)
  1780.  
  1781.          Pro~Scribe is used around the world in companies like IBM,
  1782.          Hewlett Packard, AT&T, Lockheed, Citicorp and Bank of America to
  1783.          help improve memos, letters, manuals, documentation, contracts,
  1784.          promotional material, etc.  Here's how Pro~Scribe and PSE help:
  1785.  
  1786.           * They examine your writing for many types of writing mistakes.
  1787.  
  1788.           * You can look at overall results for an entire letter,
  1789.             report, etc.  Or, if you like, they'll look at your
  1790.             writing line-by-line.
  1791.  
  1792.           * They show suspect problems, and offer suggestions.
  1793.  
  1794.           * Results are shown numerically, and with colorful graphs.
  1795.  
  1796.           * They come with two manuals (plus a Quick Reference Guide)
  1797.             - One covers basics: To install/run PS, and basic guidelines.
  1798.             - "Effective, High-Impact Writing" has more writing tips.
  1799.  
  1800.           * They're colorful, fast, fun, and a terrific value:
  1801.             $39 for both!
  1802.  
  1803.          How are Pro~Scribe and PSE different?   First, PS Express is a
  1804.          RAM-resident program.  That means it's always ready to help
  1805.          when you need help most--while you're actually writing.  Run
  1806.          PSE, then run your word processor and start writing.  Need
  1807.          help? Just press a key.
  1808.           * When PSE pops up, just mark the text you want PSE to examine.
  1809.             A window pops up instantly with feedback on your writing.
  1810.           * PSE is like having an English teacher looking over your
  1811.             shoulder, gently coaching you as you write.
  1812.  
  1813.          Pro~Scribe gives you everything PSE does, and much, much more.
  1814.          It reads files saved by your word processor, or you can type
  1815.          text directly into PS.  Like PSE, Pro~Scribe shows how complex
  1816.          your writing, words and sentences are.  It also offers you:
  1817.  
  1818.           * Feedback on "Word Wasters"  (5 categories of writing errors).
  1819.           * Three RGL (Running Grade Level) options (line-by-line feedback).
  1820.           * An option to flag complex words and Word Wasters in each line.
  1821.           * A Personal Interest score showing if you write as you speak.
  1822.           * Options to: Customize the program, send results to your printer.
  1823.  
  1824.                                                                       
  1825.  
  1826.  
  1827.          ==============================================================
  1828.          PDT                                 The Pro~Formance Data Tool
  1829.          ==============================================================
  1830.  
  1831.          Very simply, PDT is the finest data file editor available!
  1832.          If you ever have a need to edit database, binary or EBCDIC
  1833.          files, you'll find that PDT is an indispensable tool.
  1834.  
  1835.           * You can view and edit ANY type of file:  dBase files, other
  1836.             types of data files, executable files (eg., .Exe or .Com
  1837.             files), EBCDIC files, ASCII files, font files -- any file.
  1838.  
  1839.  
  1840.           * You can view and edit ANY SIZE file -- up to two gigabytes!
  1841.             Jump from the top to the bottom of any size file instantly.
  1842.  
  1843.             You can open up to 4 files at once.  View and compare
  1844.             different files.  Or work in different areas of the same
  1845.             file.  Since each file can be up to two gigabytes in size,
  1846.             you can work with up to 8 gigabytes of data at once!
  1847.  
  1848.  
  1849.           * You can manage database files like you've never been able to
  1850.             before.  PDT offers unique features to help you manage dBase
  1851.             or ANY fixed-length record file (data or font files, etc.).
  1852.  
  1853.             - PDT detects dBase ".DBF" files, formatting your "view" of
  1854.               them so fields are automatically laid out for you.
  1855.  
  1856.             - With other fixed-length data files (like those created by
  1857.               programs written in C, Pascal, BASIC, COBOL, etc.), PDT
  1858.               lets you easily and quickly define their "structure."
  1859.  
  1860.               Once you define a file's structure, which is easy to do,
  1861.               PDT formats your "view" of these files in logical rows and
  1862.               columns and offers other features as well.
  1863.  
  1864.             - Once PDT knows the structure of a file, you'll be able to:
  1865.               -- Easily view and edit the file, tabbing quickly from
  1866.                  field to field.  You can even press a key to edit
  1867.                  numeric fields stored in "packed binary" form.
  1868.  
  1869.               -- Mark blocks (either columns or records) and then:
  1870.                  Export them, Copy them, Erase or Fill them, etc.
  1871.  
  1872.               -- Expand or Shrink the width of fields.  And, if you
  1873.                  like, PDT will automatically update the dBase header
  1874.                  and its own "structure" files to reflect the change.
  1875.  
  1876.                                                     continued . . .  
  1877.  
  1878.  
  1879.          PDT (continued)
  1880.  
  1881.  
  1882.           * PDT even manages EBCDIC files -- like those found on, or
  1883.             downloaded from, large IBM computers.
  1884.  
  1885.            - PDT's dynamic EBCDIC-to-ASCII translation lets you view
  1886.              AND edit EBCDIC files in easy-to-understand ASCII mode.
  1887.              Changes you make to the file are saved to disk in EBCDIC.
  1888.  
  1889.            - PDT will even translate EBCDIC files to ASCII, or vice versa.
  1890.  
  1891.  
  1892.           * PDT can also help you:
  1893.  
  1894.             - Repair files -- regardless of their type or size.
  1895.  
  1896.             - Determine a file's structure (record or field length, etc.).
  1897.  
  1898.             - Edit executable files to customize their messages or options.
  1899.  
  1900.  
  1901.          * Finally, PDT is very logical and easy-to-use.  It offers
  1902.            about 45 different options you may use to edit and manage
  1903.            files.  And to make these easy to use, PDT offers pull-down
  1904.            menus, mouse support, fast keyboard hotkeys and extensive
  1905.            on-line help (which you can customize).
  1906.  
  1907.  
  1908.                                                                        
  1909.  
  1910.          ==============================================================
  1911.          Multi-Print                The ultimate text printing utility!
  1912.          ==============================================================
  1913.  
  1914.          Multi-Print (MP) prints ASCII text files (like this manual) on
  1915.          HP LaserJets -OR- Epson -OR- Toshiba printers (or compatibles).
  1916.  
  1917.           * Print 1, 2 or 4 PAGES of text on each SHEET of paper.  Print
  1918.             in portrait mode on BOTH sides of the paper on ANY printer,
  1919.             Or print sideways on LaserJets, Epson or Toshiba printers.
  1920.             - Choose "Booklet" mode to print books.  Print the "front"
  1921.               side, then the "back."  Then just fold it into a booklet
  1922.               and staple!
  1923.  
  1924.             - Choose "Left-to-Right" to print pages side-by-side, first
  1925.               on the left side of the page, then on the right.
  1926.  
  1927.             - Choose "1 Column" per sheet to print up to 250 characters
  1928.               per line (this is great for printing spreadsheets).
  1929.  
  1930.             - And with the last 2 options, you can choose to print 2-
  1931.               sided or 1-sided.  Then use them as-is, or slip them into
  1932.               a 3-ring binder.  (Booklets are always printed 2-sided).
  1933.  
  1934.           * Four fonts are included.
  1935.             - Our 9-point Times Roman font is a better-looking substi-
  1936.               tute for the LaserJet's "Line Printer" font (though you
  1937.               can use the Line Printer font if you wish).  With our 6-
  1938.               point Roman font, print up to 250 characters/line and 80
  1939.               lines/page (eg., spreadsheets).
  1940.  
  1941.             - Other fonts let MP print sideways on Epson/Toshiba printers.
  1942.  
  1943.           * The four fonts contain almost all ASCII characters.  Print:
  1944.             - Lines, boxes, shading, Big! Fonts (tm).
  1945.  
  1946.             - French, German, Spanish and other language characters.
  1947.  
  1948.             - "Control codes" (with ASCII values below 32) which are
  1949.                useful when you want to add arrows, "bullets," "check
  1950.                boxes" and other symbols to your text.
  1951.  
  1952.             - NOTE: Original LaserJets and LaserJet + can't print the last 2.
  1953.  
  1954.           * MP offers many printing options:
  1955.             - Print TITLES:  page numbers, the date, and the name of the
  1956.               file you're printing (or a "custom title") - in any com-
  1957.               bination. Print titles at the TOP or BOTTOM of each page
  1958.               in several "styles."
  1959.  
  1960.             - Print "both" sides, or just the "front" or "back" side.
  1961.  
  1962.             - Control Top, Left and Right Margins.  "Wrap" long lines
  1963.               (LaserJets only).  Print to LPT1, 2 or 3 or "to a file."
  1964.  
  1965.           * MP is menu-driven; choose options using a mouse or the keyboard.
  1966.                                                                        
  1967.  
  1968.  
  1969.          ==============================================================
  1970.          inform-Z (also see Mail Call below)  Professional Forms Design
  1971.          ==============================================================
  1972.  
  1973.          inform-Z is a complete form system.  Built-in features include:
  1974.          easy form design, math, "auto-edit," high quality printing, etc.
  1975.  
  1976.          Design, edit and print forms with inform-Z.
  1977.  
  1978.           * Draw lines or boxes, or add shading, in several styles.
  1979.  
  1980.           * Enter text, auto-centered inside boxes if you like.
  1981.  
  1982.           * Automatically date, sequence number and time-stamp forms.
  1983.  
  1984.           * Add "formulas" for spreadsheet convenience, speed & accuracy.
  1985.  
  1986.           * Quick, easy block options:  Copy, Move, Erase, Shading.
  1987.  
  1988.           * Vary fonts, type styles, line spacing.
  1989.  
  1990.           * inform-Z is very easy to use.  And it's "lesson forms" cut
  1991.             the learning time dramatically.
  1992.  
  1993.  
  1994.          Then use inform-Z or Mail Call to fill out forms.
  1995.  
  1996.           * "Auto-Edit" fields lets you quickly skip through a form,
  1997.             editing just fields you "marked."  On order forms, for
  1998.             example:  Quantity, Description, Price per Unit.  Math
  1999.             options will do the math for you!
  2000.  
  2001.           * Let Mail Call fill in other information for you -- pulling
  2002.             names, addresses, etc. from your database, putting them
  2003.             where you want them.
  2004.  
  2005.          Produce high-quality, professional looking forms in minutes
  2006.          with Epson printers or HP LaserJets (+/500/Series II or later).
  2007.          And you DON'T need expensive font cartridges or soft fonts for
  2008.          lines, boxes, shading, etc.  We use built-in features for
  2009.          these.  "But, I don't have a LaserJet or an Epson" you say.
  2010.          Not to worry. inform-Z has two other printer options so it
  2011.          works with any printer.
  2012.  
  2013.          Together, inform-Z and Mail Call can help you manage almost
  2014.          every piece of paper in your office.
  2015.  
  2016.            Forms:       Invoices, Purchase Orders, Personnel Forms, Work
  2017.                         Orders, Work Schedules, Travel or Expense Reports,
  2018.                         Accounting Forms, Application Blanks, Org. Charts
  2019.  
  2020.            As Well As:  Letters, Memos, Envelopes, Mailing Labels,
  2021.                         Personalized Documents (ie., form letters),
  2022.                         Reports, Client or Employee lists, etc.
  2023.                                                                        
  2024.  
  2025.          ==============================================================
  2026.          Mail Call and MC Express (MCE)           Our mailing assistant
  2027.          ==============================================================
  2028.  
  2029.          Mail Call (MC) is a full featured mailing assistant.  Add names
  2030.          to a database, then Browse, Search, Print, Sort, etc.
  2031.  
  2032.           * Print envelopes in several sizes.
  2033.  
  2034.           * Print mailing labels (several sizes plus a "roll-your-own-
  2035.             size" option) 1 to 99 copies of each label, 1 to 3 columns
  2036.             across.
  2037.  
  2038.           * Print personalized documents (or form letters).
  2039.  
  2040.           * Print forms -- with "auto-edit," date, sequence number and
  2041.             math features!
  2042.  
  2043.           * Print reports, phone books, appointment schedules, etc.
  2044.  
  2045.          Mail Call offers UNlimited capacity -- use as many database
  2046.          files as you want.  And its "Mail Merge" option lets you
  2047.          Import or Export names to files used by word processors or
  2048.          other database programs.
  2049.  
  2050.          MC Express, a "RAM-resident" program, that lets you:  1) print
  2051.          envelopes while INSIDE your word processor; and, 2) lets you
  2052.          "write out" names & addresses to a file you can later "import"
  2053.          into MC (no re- typing).  MCE, optional, works with ALL
  2054.          versions of the HP LaserJet.
  2055.  
  2056.                                                                        
  2057.  
  2058.          ==============================================================
  2059.          P~F Presents  (PFP)              A DESKTOP PRESENTATION System
  2060.          ==============================================================
  2061.  
  2062.          P~F Presents comes with several programs to help you create,
  2063.          manage and display presentations.  The two main programs are
  2064.          P-Screen and PFP.
  2065.  
  2066.          With P-Screen you:       (See below for more on P-Screen)
  2067.          ------------------
  2068.  
  2069.           * Design screens (or "slides").
  2070.  
  2071.           * Save screens in libraries (or print them, or save them to
  2072.             ASCII files, or executable ".COM" files.)
  2073.  
  2074.           * NOTE: We offer TWO "screen-capture" programs to help you
  2075.             capture screens from existing applications.  One captures
  2076.             text screens.  The other captures ANY type of screen!
  2077.  
  2078.  
  2079.          With PFP you:
  2080.          -------------
  2081.  
  2082.           * Create presentation agendas ("slide shows") which can include:
  2083.  
  2084.             - Menus which "branch" to various parts of your presentation,
  2085.               depending on the option your viewer selects.  For example:
  2086.  
  2087.               -- Which product do you want information on?
  2088.               -- Which topic (in a tutorial) do you want to review?
  2089.  
  2090.             - Timed slides (PFP pauses, then automatically shows the next)
  2091.  
  2092.             - Special effects:  animation, sound, loops, exploding windows
  2093.  
  2094.           * Display your presentations, or let others do it by them-
  2095.             selves. A "use monochrome" option lets you display presen-
  2096.             tations on virtually any monitor.
  2097.  
  2098.          The Possibilities are Endless:
  2099.          ------------------------------
  2100.  
  2101.           * Sales presentations          * Management/Staff briefings
  2102.           * Training programs            * Tutorials or Demos
  2103.           * Meetings                     * Highlight product information
  2104.           * Investment opportunities     * Advertising on disk (SoftAds)
  2105.           * Customer information         * Tourist guides
  2106.           * Restaurant guides            * Directories (Names, phone #s)
  2107.  
  2108.                             And on and on and . . .
  2109.  
  2110.  
  2111.                                                                        
  2112.  
  2113.  
  2114.          ==============================================================
  2115.          P-Screen & P-Screen Professional     QuickBASIC screen support
  2116.          ==============================================================
  2117.  
  2118.          P-Screen is a screen: "design," "library/database" and
  2119.          "display" system all in one.  Use it to design screens for
  2120.          programs you write, or for program demos, prototyping, word
  2121.          processing, batch files, etc.
  2122.  
  2123.          * Draw/Join lines or boxes, in several styles
  2124.          * Shade or Paint entire screens or selected areas
  2125.          * Enter text, auto-centered inside lines or boxes if you like
  2126.          * Quick, easy block options:  Copy, Move, Erase, Shade, Paint,
  2127.            UnDo.
  2128.  
  2129.          Save/Load/Libraries
  2130.  
  2131.          * Save screens to or Load screens from ASCII files or Libraries.
  2132.            You can also save executable "Com" screens -- colors and all!
  2133.            - We include Capture to "grab" screens from other applications.
  2134.  
  2135.          * Libraries give you the convenience of 1 file to store up to 50
  2136.            screens -- in color, complete with names and descriptions.
  2137.  
  2138.          Using screen libraries in your programs, demos, etc.
  2139.  
  2140.          * We supply routines to display your screens from QuickBASIC
  2141.            programs (QB 3-4.x).
  2142.  
  2143.          * It's easy to write programs to access screen libraries.
  2144.            - You can load and display 1 screen at a time.
  2145.            - Or load 2 or more screens into arrays, then pop them up
  2146.              instantly.
  2147.  
  2148.          P-Screen Professional even writes your QB programs for you!!
  2149.          And it comes with several other subprograms you can use in any
  2150.          program.   Call for **significant** details.
  2151.  
  2152.                                                                        
  2153.  
  2154.  
  2155.          ==============================================================
  2156.          The Survey Catalyst      (A commercial program, not Shareware)
  2157.          ==============================================================
  2158.  
  2159.          The Survey Catalyst (TSC) is for anyone who works with attitude/
  2160.          opinion surveys.  Create surveys in minutes or hours -- not days!
  2161.  
  2162.           * TSC includes a database of thousands of survey items--like
  2163.             items used in most Fortune 1000 companies' employee surveys.
  2164.  
  2165.             - You can review items, edit them or add new ones.
  2166.  
  2167.             - OR, when you see an item you want to add to a survey, just
  2168.               press a key and add it--fast and simple.
  2169.  
  2170.           * TSC also comes with dozens of response scales.  When you print
  2171.             surveys, TSC prints the right response scale--automatically.
  2172.  
  2173.           * And speaking of printing, TSC's many options let you create
  2174.             "camera-ready" copy--as you want it, fast!
  2175.  
  2176.             - Group items by Category, by Response Scale, or Randomize them.
  2177.  
  2178.             - Print response scales Above or Beside items (or not at all).
  2179.  
  2180.             - Print key punch instructions (optional)
  2181.  
  2182.             - Print a title--at the top or bottom of each page.
  2183.  
  2184.             - Or, print your survey "to a file"--to dress it up later.
  2185.  
  2186.          ==============================================================
  2187.          Pro~Stamp                             Stamp Collection Manager
  2188.          ==============================================================
  2189.  
  2190.          Pro~Stamp is our full-featured stamp collection manager.
  2191.  
  2192.           * It's very easy to use:  pull-down menus, extensive on-line
  2193.             help; Calculations done for you, select "Type" & "Condition"
  2194.             from menus, and more.
  2195.  
  2196.           * Your worksheets are set up like most popular collectors'
  2197.             manuals (eg., Scott).
  2198.  
  2199.           * Track small to huge stamp collections, with ease and convenience.
  2200.  
  2201.           * Multiple file options add flexibility (subsets of collections)
  2202.  
  2203.           * Automatic calculations (Values of each stamp, Increase in
  2204.             value) give you spreadsheet convenience.
  2205.  
  2206.           * Sort:  On any of several fields.
  2207.  
  2208.           * Print:  Entire worksheets or a range you specify.
  2209.  
  2210.           * It's customizable:  Edit menu items or printer codes your way. 
  2211.                                                                          
  2212.  
  2213.          ==============================================================
  2214.          Ram-Man                              RAM-resident file browser
  2215.          ==============================================================
  2216.          Ram-Man is a RAM-resident (TSR) program to turn ANY text file
  2217.          into a pop-up quick-reference guide (or manual).  For example,
  2218.          keep THIS MANUAL at your fingertips while learning inform-Z!
  2219.           * Pop up your text file while you're working in virtually any
  2220.             text-based (not graphics) program (including inform-Z).
  2221.           * BROWSE through it.
  2222.           * SEARCH, looking for a topic or phrase you're interested in.
  2223.           * LOOK UP words, which we'll read directly from your screen!
  2224.  
  2225.          We supply the RAM-resident "engine," you supply the text.  Ram-
  2226.          Man preserves DOS memory by keeping ONLY its engine in memory.
  2227.          It displays your text from disk (hard or RAM disk recommended).
  2228.  
  2229.          You can change which file you're viewing without unloading
  2230.          Ram-Man.  That means you load Ram-Man once, then change ref-
  2231.          erence guides as your needs or the programs you use change.
  2232.                                            
  2233.          Now, regardless of which text-based program you're using (or
  2234.          even at the DOS prompt), you can have on-line, pop-up help
  2235.          available -- at any time, at the press of a key.
  2236.  
  2237.          Examples:       
  2238.           * The complete, on-disk manual for a program you're using.
  2239.           * A series of help screens or "Quick Reference Guides"
  2240.             (eg., tips on using DOS, tips on using a program).
  2241.             - You can display standard DOS text files, like those
  2242.               you create using an editor or word processor.
  2243.             - Or you can display special "screens" you create with
  2244.               programs like our P-Screen Screen Designer.
  2245.           * Appointment Calendars, To Do Lists. . . . etc.
  2246.  
  2247.          Other features:   (<R> = REGISTERED versions.)
  2248.  
  2249.           * BROWSE through files -- line by line or page by page.  And
  2250.             you can jump to the top or bottom of small -or- huge text
  2251.             files in 1/2 second or less.
  2252.  
  2253.           * SEARCH for topics relevant to your needs.
  2254.  
  2255.           * <R> "LOOK UP" reads a word directly off your screen THEN
  2256.             searches for it!  BE SURE to read the section on Look Up for
  2257.             uses (eg., Quick reference, spelling, thesaurus, quotations).
  2258.  
  2259.           * UNLOAD Ram-Man and reclaim the memory it uses.
  2260.  
  2261.           * <R>  RUN-TIME OPTIONS let you choose:
  2262.             - The "hotkey" you want to use to call Ram-Man up.
  2263.             - The size of the screen you want to use -- to let you
  2264.               switch between 25, 43 or 50 row screens at will.
  2265.             - The colors we use to display text.
  2266.  
  2267.               These options help ensure that Ram-Man's hotkey, colors
  2268.               and screen modes never conflict with the programs you use. 
  2269.  
  2270.  
  2271.          ==============================================================
  2272.          SPARKLE & MENU MAGIC     Add some sparkle to your batch files.
  2273.          ==============================================================
  2274.  
  2275.          Sparkle is an AMAZING utility to enhance batch files, use from
  2276.          DOS, or use through other programs (via "shell").  And Sparkle
  2277.          now includes Menu Magic which lets you quickly create scrolling
  2278.          bar menus (see Menus below) and writes your batch files for you!
  2279.  
  2280.          One small (9k) program offers these many features:
  2281.  
  2282.           * MENUS      Sparkle offers 3 menu options.  Turn ANY screen
  2283.                        into a menu.  Or turn ANY text screen into a
  2284.                        Vertical or Horizontal"scrolling bar" menu.
  2285.  
  2286.           * SOUND      Over 35 sound effects, ranging from simple to
  2287.                        the William Tell Overture!
  2288.  
  2289.           * WINDOWS    Create windows (boxes) on screen in over 250
  2290.                        styles, with/without shadows, and in any color.
  2291.  
  2292.           * QuikPRINT  Display text anywhere on the screen in any color.
  2293.  
  2294.           * ASK        Ask the user to press a key -- to get a menu
  2295.                        choice or to simply pause.
  2296.                        - You can display any message you like in any color.
  2297.                        - You can specify which keys are "valid."  For
  2298.                          example, suppose your menu had 3 choices and
  2299.                          you ask someone to press 1, 2 or 3 to choose
  2300.                          one of them.  Just tell Sparkle that "123" are
  2301.                          your "valid keys."  Sparkle will wait until one
  2302.                          of these keys (or Escape) is pressed -- then
  2303.                          tell you which one was pressed.
  2304.  
  2305.           * PAUSE      You can pause for brief moments (1/3 second) or
  2306.                        for several minutes.  And Sparkle even gives you
  2307.                        the option to let your users "press a key" to
  2308.                        interrupt a pause and move on.
  2309.  
  2310.           * MONITOR    Determine what type of monitor is active.
  2311.  
  2312.                                                                        
  2313.  
  2314.          ==============================================================
  2315.          VIDLIB               A commercial-quality Video Tape Librarian
  2316.          ==============================================================
  2317.  
  2318.          VIDLIB has every feature that every other video tape program
  2319.          offers.  And the author guarantees to add any feature another
  2320.          program has that VIDLIB doesn't.  ANY feature ... GUARANTEED!
  2321.  
  2322.          VIDLIB stores 27 different pieces of information about each
  2323.          tape in your collection.
  2324.  
  2325.            - Tape number, recording's title, Category (adventure,
  2326.              romance, sci-fi, etc.), Rating (G, PG, R, etc.), origin
  2327.              (purchased, television, home recording, HBO, etc), stars
  2328.              appearing, director, studio, color or B&W, cost, date re-
  2329.              corded, recording speed, recording length, footage start
  2330.              and end, what language is spoken, subtitles?, cabinet
  2331.              and/or shelf where tape is stored, date the tape was
  2332.              loaned, who borrowed it.
  2333.  
  2334.            - No field is required!  Use or ignore any information field
  2335.              you like.  Use what you want; ignore what you don't.
  2336.  
  2337.            - Use 2 word processor-like windows to describe each record-
  2338.              ing on a tape and describe its honors, awards or nominations.
  2339.  
  2340.            - Depending on YOUR tastes, use the unique 5 star rating
  2341.              system to Rate each individual recording.
  2342.  
  2343.            - Many fields can be redefined by the user.
  2344.  
  2345.          VIDLIB handles an unlimited number of tapes with an unlimited
  2346.          number of recordings per tape.
  2347.  
  2348.          VIDLIB offers easy-to-use, yet surprisingly powerful printout
  2349.          support.
  2350.  
  2351.            - Print 3 different Avery labels available from your local
  2352.              office supply store:  labels for the tape spine, tape face
  2353.              and the tape box.
  2354.  
  2355.            - Print 2 Rolodex and 3 index card formats and sizes.  VIDLIB
  2356.              supports pin-feed Avery formats, too.
  2357.  
  2358.            - Three report formats including a beautiful catalog sheet
  2359.              and a special report for your insurance company!
  2360.  
  2361.            - Supports dot-matrix, laser or letter quality printers.
  2362.  
  2363.          VIDLIB is exceptionally fast on any computer, even XT's and
  2364.          PC's.  It works handsomely on color or monochrome monitors.
  2365.  
  2366.          And VIDLIB uses the popular dBase (DBF) file structure.  So
  2367.          you can access, read and edit VIDLIB databases using dBase III,
  2368.          dBase III+, dBase IV, Clipper -- or our own PDT program.
  2369.                                                                        
  2370.  
  2371.          ==============================================================
  2372.                             Registering and Ordering
  2373.          ==============================================================
  2374.          Because we offer so many programs, our order form has 2 pages.
  2375.  
  2376.           * THIS PAGE lists our programs and the per-copy cost of each.
  2377.             The section immediately above describes each or our programs.
  2378.  
  2379.           * THE NEXT PAGE is the actual order form.
  2380.  
  2381.             - On the next page, fill in the name of each program you're
  2382.               ordering.  PLEASE BE CAREFUL here and use the names listed
  2383.               below.  If we're not sure which program you're ordering,
  2384.               we may have to return you're order (or call collect?).
  2385.  
  2386.             - If ordering by Visa or MasterCard, fill in the section
  2387.               for credit card orders.  BE SURE TO SIGN it.
  2388.  
  2389.          Program Name                                          Per Copy
  2390.          ==============================================================
  2391.          Text Font, TF-R (Resident) plus complete font library   $19
  2392.  
  2393.          Multi-Print      Recommended! ($25 w/ purchase > $100)  $39
  2394.  
  2395.          PDT              The Pro~Formance Data Tool             $99
  2396.  
  2397.          inform-Z         Professional Forms Design/Database     $49
  2398.  
  2399.          Mail Call        With MC Express                        $49
  2400.            "    "         Without MC Express                     $45
  2401.  
  2402.          Pro~Scribe & PS Express                                 $39
  2403.  
  2404.          P~F Presents     Professional                           $79
  2405.           "     "         Plus (with intro. copyright)           $49
  2406.  
  2407.          P-Screen Professional                                   $49
  2408.              "    Plus                                           $29
  2409.  
  2410.          Pro~Stamp        Stamp Collection Manager               $29
  2411.  
  2412.          Ram-Man          RAM-resident Text File Browser         $19
  2413.  
  2414.          Sparkle, Sparkle2 AND Menu Magic                        $29
  2415.  
  2416.          VidLib           Video Tape Librarian and Database      $39
  2417.  
  2418.          The Survey Catalyst                                    $495
  2419.           "    "        "   Demo Disk (refunded with purchase)    $5
  2420.  
  2421.        =================================================================
  2422.        PACKAGE DISCOUNTS  Call about quantity discounts & site licenses.
  2423.        =================================================================
  2424.          inform-Z AND Mail Call                                  $79
  2425.  
  2426.          P-Screen Pro AND P~F Presents  (Pro versions of both)  $109
  2427.                                                                        
  2428.  
  2429.   =============================== TO  ORDER  ===============================
  2430.  
  2431.    For FASTEST delivery of your programs, CALL with your Visa/MC card number.
  2432.  
  2433.    F ____________________________________________  M    Rob W. Smetana
  2434.                                                         Pro~Formance
  2435.    R ____________________________________________  A T  132 Alpine Terrace
  2436.                                                         San Francisco, CA 94117
  2437.    O ____________________________________________  I O  (415) 863-0530
  2438.  
  2439.    M ____________________________________________  L    Make checks payable to
  2440.                                                             Rob W. Smetana
  2441.    Phone (      ) ______-________  Date ___/___/___
  2442.  
  2443.   ----------------------------------------------------------------------------
  2444.                           For Visa or MasterCard Orders
  2445.   ----------------------------------------------------------------------------
  2446.  
  2447.    Credit Card Number:  __________________________________   Expires: ___|___
  2448.  
  2449.    Signature (Required for credit card orders): _____________________________
  2450.  
  2451.     Be sure your name at the top matches how it appears on your credit card.
  2452.  
  2453.   ================================================================== spk 3.0 =
  2454.  
  2455.   Program/Package Name (see last page)    # of Copies  Price/Copy     Total
  2456.  
  2457.   ============================================================================
  2458.  
  2459.   ________________________________________  ________  x  ______   =  $_______
  2460.  
  2461.   ________________________________________  ________  x  ______   =  $_______
  2462.  
  2463.   ________________________________________  ________  x  ______   =  $_______
  2464.  
  2465.   ________________________________________  ________  x  ______   =  $_______
  2466.  
  2467.   ________________________________________  ________  x  ______   =  $_______
  2468.  
  2469.   ________________________________________  ________  x  ______   =  $_______
  2470.  
  2471.   ----------------------------------------------------------------------------
  2472.  
  2473.   Shipping & Handling::: Total Number         @ $4/copy (US/Canada)
  2474.   of Programs (and Copies)    ----->>  _____  @ $8/copy (Elsewhere) $ _______
  2475.  
  2476.   -----------------------------+----------------------------------------------
  2477.                                |                          Subtotal  $ ________
  2478.    INTERNATIONAL ORDERS: : :   |
  2479.                                | California residents, add 8.5% tax $ _______
  2480.    * US funds only please.     +-------------------------+--------------------
  2481.    * Money order, check drawn a                          |
  2482.      US bank, or VISA/MasterCard                         |   TOTAL  $ ________
  2483.   -------------------------------------------------------+--------------------
  2484.   PLEASE tell us where you got a copy of our program.  This information helps
  2485.   us determine how we can best get new programs to you and other users.
  2486.                                                                           
  2487.  
  2488.